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 (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.

Additional fields for delivery channels

For delivery channels like Uber Eats, Just Eat and Deliveroo, a few other fields can be specified, which will help customers find your products more easily.

Field	Required	Description
price_markup_deliveroo	optional	The percentage price markup for the product on Deliveroo, e.g. specify `20` to add a 20% markup on the normal product price.
price_markup_uber_eats	optional	The percentage price markup for the product on Uber Eats, e.g. specify `20` to add a 20% markup on the normal product price.
price_markup_just_eat	optional	The percentage price markup for the product on Just Eat, e.g. specify `20` to add a 20% markup on the normal product price.
menu_categories	optional	The categories in which the product is listed on the delivery platform. This is a comma-separated list of categories, e.g. `Off-License, Red Wine`. In most platforms, the first category is used as the top-level menu category or aisle, and the second as the sub-category.
tax_percentage	optional	The tax percentage for the product, e.g. `20` for 20% tax. This is expected to be included in the specified price. This is used to calculate the final VAT amount on the customer delivery receipt.
classifications	optional	A comma-separated list of classifications for the product, e.g. `alcohol_product`. This is used to classify the product for dietary requirements.

Available classifications

early_stage_infant_formula: This includes all infant formula products, excluding follow on formula products
pharmaceuticals_aspirin: Any product that is exclusively or contains aspirin
pharmaceuticals_ibuprofen: Any product that is exclusively or contains ibuprofen
pharmaceuticals_paracetamol: Any product that is exclusively or contains paracetamol
alcohol_product: Any product containing alcohol - age restrictions apply (18+)
vape_product: Any e-cigarette or 'vape' product - age restrictions apply (18+)
tobacco_product: Any product containing tobacco - age restrictions apply (18+)
cbd_product: Any product containing CBD - age restrictions may apply (18+)

Additional fields for weighted product

For weighted products, we suggest specifying the measure of your product. The unit_pricing_measure attribute allows customers to understand the exact cost per unit of your product.

If your product falls into any of the mentioned categories and customers are likely to be interested in its price per unit, it is recommended that you include the unit pricing measure attribute.

Here are some examples of product categories that commonly employ this attribute:

Food
Drinks
Flooring
Perfume

To ensure that Google understands the data you submit, adhere to these formatting guidelines:

Type: A positive number followed by the respective unit.
Supported units:
- Weight: oz, lb, mg, g, kg
- Volume (US imperial): floz, pt, qt, gal
- Volume (metric): ml, cl, l, cbm
- Length: in, ft, yd, cm, m
- Area: sqft, sqm
- Per unit: ct

Example

Let's say you submit '10 EUR' for the price, '500 grams' for the unit pricing measure attribute, and '1 kg' for the unit pricing base measure attribute. In this case, the unit price would be 20 EUR per kilogram.

{
  "unit_pricing_measure": "500g",
  "unit_pricing_base_measure": "1kg"
}

Attributes

Field	Description
unit_pricing_measure	To specify the measure of your product, particularly for weighted products, you can make use of the attribute called `unit_pricing_measure`. This attribute allows customers to understand the exact cost per unit of your product.
unit_base_pricing_measure	The `unit_pricing_base_measure` attribute enables you to convey the price conversion of your product based on a specific unit. For example, if you were selling a 150-milliliter bottle of perfume, this attribute would allow you to present customers with the cost of your perfume per 100 milliliters.

Product data Example products.csv