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
category
Optional Google product taxonomy value. 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.

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.

Field	Description
link	Online product page URL, if any. Optional.
condition	Condition of the product. Defaults to `new`. Valid options: `new`, `refurbished`, `used`
category	Optional Google product taxonomy value. Example value: `Home & Garden > Lighting`

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.

Last modified 2mo ago