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? ​

Vendors can set additional listing specifications in Garnet > Listings > Upload listing. You will only see the section Specifications if there are no specifications in your marketplace.

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.

Specifications can be of different types:

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

Spcecifications 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:

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.

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:

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:

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:

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

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