Search…
⌃K

Product fields

These are the main fields your products.csv file should contain.

Required fields

Field
Description
barcode
Identifier to link to products in your stock.csv file.
brand
Name of the brand or manufacturer that produced the item.
title
Customer-facing product title.
image_url
Public HTTP or HTTPS image URL for the product. Should be at least 250x250 pixels in size.
description
Product description, ideally between 100 and 4000 characters long.

Optional fields

Field
Description
link
Online product page URL, if any. Optional.
condition
Condition of the product. Defaults to new. Valid options: new, refurbished, used

Additional fields for apparel

For apparel products, there are a few other fields to give shoppers a better experience searching for these types of products.
Whilst they are currently not required, depending on the requirements of our upstream providers, we might make these properties required in the future.
Field
Required
Description
age_group
optional
Any of: newborn, infant, toddler, kids, adult.
gender
optional
Any of: male, female, unisex.
color
optional
Any string, for example blue.
size
optional
Any string, for example 16/34 or XL.
item_​group_​id
optional
Used to group variants of the same product. This property is required if there’s more than one product in the same set (i.e. different sizes or colors of the same product). Set it to the same value for each of the products in one set. This value can be any alphanumeric string, e.g. an UUID.