Skip to content

Listing specifications

Each marketplace needs to be tailored to its industry. Marketplaces must request vendors to add additional data to their products to boost their marketplace.

Here are some use cases:

  • automatically add products to a collection
  • display more product context to the end customer
  • use additional information in internal automation

Where are specifications used?

When creating a new product, vendors set the specifications in Garnet > Listings > Upload listing. Note that if you don't have any specification set, the section Specification is hidden.

specs-page

Moreover, when uploading a CSV, all specifications will be available for mapping the data from the CSV to Garnet.

Internally, a specification is a Shopify metafield definition. It is accessible in the Shopify admin console, in Shopify collections, theme templates, and in the liquid code.

Add specifications

Specifications can be added and edited by the marketplace admin following Garnet > Admin panel > Specifications.

add-spec

Specifications can be of different types:

TypeDescriptionExamples
Short textText of any size that fits on one lineArtist name, CPU, City
Long textText of any size that fits on several linesDelivery details, Cancellation policy
DecimalNumber with any number of decimalHeight (ft), Diameter (cm)
IntegerNumber without any decimalPublication year, mileage (mi)
CheckboxSeveral choices of predefined valuesShipping options, Compatible with
True/FalseYes or no questionLocal delivery only, Box included

Garnet supports more specification types and format for some businesses (like calendar booking, product suggestions and more), contact us to know more about it.

Specifications style

Some specification can be displayed with various style. For instance you can use a text field to upload an image, or a video. In the short clip below, you can see how to use a radio button instead of a drop down for a Short text specification:

specifications style demo

Conditional display

For marketplaces with a lot of specifications, it can be useful to show/hide them conditionally. For instance, you can ask the vendor to Upload the certification proof only when the Certification has been chosen.

It makes the interface lighter and does not bother vendors with fields that they are not concerned by.

conditional specifications

To set the conditional display, go to your specfications and change the value Show to when {an other field} is set.

Edit or remove specifications

You can safely edit and remove specifications from Shopify. We provide a direct link in the Admin panel.

To delete the specification, scroll all the way down and select Delete fields and their saved values to completely remove the field and its data. Be careful, the data cannot be recovered once removed.

edit remove specifications

Specifications sections

Some marketplaces have dozens of specifications and it can be confusing for navigate through all these fields. Garnet provides Sections you can configure in Admin Panel > Specifications > Sections.

section settings

You can reorder specifications, and sections from this view. By default, unorganised specifications land in a section called Others.

Here how it looks like on the product upload page:

section display

Automatically add products to a collection

A common use case is to add products to a collection depending on custom data.

To do so, edit the custom data and check Access options > Automated collections for the field in question.

Then you can create a Shopify collection with the condition {your field} is equal to {value}. Checkout the video:

collection-create

Display custom data on your product page

Before using the data in your storefront, you must turn on the custom data option Access options > Storefront. You can then use your new field with the theme interface or liquid code.

Using Shopify theme

To use custom data in your theme, open the product page and using the button Insert dynamic source, you can select the custom data. See the video for more details:

spec-in-theme

Using liquid templates

Using liquid, you must locate the metafield key in Shopify's settings. It should look like custom.xxx where xxx is a unique key for your custom data. Then in your template code, insert the value with:

liquid
{{ product.metafields.custom.xxx.value }}

spec-in-liquid