POS Integrations
Custom product data
Product fields

Product fields

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

Required fields

FieldDescription
barcodeIdentifier to link to products in your stock.csv file.
brandName of the brand or manufacturer that produced the item.
titleCustomer-facing product title.
image_urlPublic HTTP or HTTPS image URL for the product. Should be at least 250x250 pixels in size.
descriptionProduct description, ideally between 100 and 4000 characters long.

Optional fields

FieldDescription
linkOnline product page URL, if any. Optional.
condition

Condition of the product. Defaults to new.
Valid options: new, refurbished, used

categoryOptional Google product taxonomy value (opens in a new tab). Example value: Home & Garden > Lighting

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.

FieldRequiredDescription
age_groupoptionalAny of: newborn, infant, toddler, kids, adult.
genderoptionalAny of: male, female, unisex.
coloroptionalAny string, for example blue.
sizeoptionalAny string, for example 16/34 or XL.
item_group_idoptionalUsed 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.