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 |
category | Optional 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.
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. |