Product data specification

Condition [condition]

The condition of your product at time of sale

Required if your product is used or refurbished

Optional for new products

Example
new

Supported values

New [new]
Brand new, original, unopened packaging
Refurbished [refurbished]
Professionally restored to working order, comes with a warranty, may or may not have the original packaging
Used [used]
Previously used, original packaging opened or missing

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Adult [adult]

Indicate a product includes sexually suggestive content

Required (If a product contains adult content)

Example
yes

Supported values

Schema.org property: No

Set the value of this attribute to yes if this individual product contains nudity or sexually suggestive content. If you don’t submit the attribute, the default value is no. Learn about the adult-oriented content policy
If your website is generally focused on an adult audience and contains adult-oriented content with or without nudity, indicate that in your Merchant Center settings.

Find these settings in the “Business details” tab.

Multipack [multipack]

The number of identical products sold within a merchant-defined multipack

Required (For multipack products in Australia, Brazil, Czechia, France, Germany, Italy, Japan, Netherlands, Spain, Switzerland, the UK and the US)

Required for free listings on Google if you’ve created a multipack

Optional for all other products and target countries

Example
6

Syntax
Integer

Schema.org property: No

Submit this attribute if you defined a custom group of identical products and are selling them as a single unit of sale (for example, you’re selling 6 bars of soap together).
Submit the number of products in your multipack. If you don’t submit the attribute, the default value is 0.
If the product’s manufacturer assembled the multipack instead of you, don’t submit this attribute.

Bundle [is_bundle]

Indicates a product is a merchant-defined custom group of different products featuring one main product

Required (For bundles in Australia, Brazil, Czechia, France, Germany, Italy, Japan, Netherlands, Spain, Switzerland, the UK and the US)

Required for free listings on Google if you’ve created a bundle containing a main product

Optional for all other products and target countries

Example
yes

Supported values

Schema.org property: No

Submit yes if you’re selling a custom bundle of different products that you created, and the bundle includes a main product (for example, a camera combined with a lens and bag). If you don’t submit the attribute, the default value is no.
Don’t use this attribute for bundles without a clear main product (for example, a gift basket containing cheese and crackers).

Certification [certification]

Certifications, such as energy efficiency ratings, associated with your product

Available for the EU and EFTA countries and the UK

Required for products that require certain certification information to be shown in your Shopping ads or free listings, for example due to local energy efficiency labeling regulations

Optional for all other products

Note: Starting April 2025, for products targeting countries in the European Union and that are required to show graphical energy efficiency class labels, use the certification [certification] attribute, which references the necessary graphical energy efficiency source data through the EU EPREL database. The energy efficiency class [energy_efficiency_class] attributes are now only available for products that target Switzerland, Norway, or the United Kingdom.

Example

EC:EPREL:123456

Syntax

This attribute uses the following sub-attributes:

Authority [certification_authority] Certification authority. Only “EC” or “European_Commission” supported.
Name [certification_name] Name of the certification. Only “EPREL” supported.
Code [certification_code] Code of the certification. For example, for the EPREL certificate with the link https://eprel.ec.europa.eu/screen/product
/dishwashers2019/123456 the code is 123456

Schema.org property: No

Consult EU energy efficiency regulations or any applicable local law to determine if you need to provide this attribute. This includes products covered by EU energy labels, for example:

Domestic ovens
Electronic displays such as televisions and other external monitors
Fridges and freezers
Household dishwashers
Household tumble dryers (rescaled as of July 1, 2025)
Household washing machines and washer-dryers
Light sources
Range hoods
Refrigerating appliances with a direct-sales function
Smartphones and tablets (starting June 20, 2025)
Solid fuel boilers
Space heaters
Tyres
Ventilation units
Water heaters

Energy efficiency class [energy_efficiency_class]

Your product’s energy efficiency class

Only available for products that target Switzerland, Norway, or the United Kingdom.

Optional (except when required by local law or regulations)

Note: Starting April 2025, the energy efficiency class [energy_efficiency_class] attributes are only available for products that target Switzerland, Norway, or the United Kingdom and are not sold in the EU. For products targeting countries in the European Union and are required to show the graphical energy efficiency class, use the certification [certification] attribute, which references the necessary graphical energy efficiency source data from the EU through the EPREL database.

Example
A+

Supported values

A+++
A++
A+
A
B
C
D
E
F
G

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include the legally required energy class.
To be used in combination with minimum energy efficiency class [min_energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to G).

Minimum energy efficiency class [min_energy_efficiency_class]

The minimum energy efficiency class in this products’s category.

Only available for products that target Switzerland, Norway, or the United Kingdom.

Optional (except when required by local laws or regulations)

Note: Starting April 2025, the minimum energy efficiency class [min_energy_efficiency_class] attribute is only available for products that target Switzerland, Norway, or the United Kingdom and are not sold in the EU. For products targeting countries in the European Union and are required to show the graphical energy efficiency class, use the certification [certification] attribute, which references the necessary graphical energy efficiency source data from the EU through the EPREL database.

Example
A+++

Supported values

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include the legally required minimum energy efficiency class.
To be used in combination with energy efficiency class [energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to D).

Maximum energy efficiency class [max_energy_efficiency]

The maximum energy efficiency class in this product’s category.

Only available for products that target Switzerland, Norway, or the United Kingdom.

Optional (except when required by local laws or regulations)

Note: Starting April 2025, the maximum energy efficiency class [max_energy_efficiency] attribute is only available for products that target Switzerland, Norway, or the United Kingdom and are not sold in the EU. For products targeting countries in the European Union and are required to show the graphical energy efficiency class, use the certification [certification] attribute, which references the necessary graphical energy efficiency source data from the EU through the EPREL database.

Example
D

Supported values

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include the legally required maximum energy efficiency class.
To be used in combination with energy efficiency class [energy_efficiency_class] and minimum energy efficiency class [min_energy_efficiency_class] to create a textual or graphical energy efficiency label, for example, A+ (G to A+++).

Age group [age_group]

The demographic for which your product is intended

Required (For all apparel products that are targeted to people in Brazil, France, Germany, Japan, the UK, and the US as well as all products with assigned age groups)

Required for free listings for all Apparel & Accessories (ID: 166) products

Optional for all other products and target countries

Example
infant

Supported values

Newborn [newborn]
0-3 months old
Infant [infant]
3-12 months old
Toddler [toddler]
1-5 years old
Kids [kids]
5-13 years old
Adult [adult]
Teens or older

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include one value per product.
For variants:
- Include the same value for item group ID [item_group_id] and different values for age group.

Color [color]

Your product’s color(s)

Required (For all apparel products that are targeted to Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different colors)

Required for free listings for all Apparel & Accessories (ID: 166) products

Optional for all other products and target countries

Example
Black

Syntax
Max 100 alphanumeric characters (max 40 characters per color)

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Don’t use a number such as “0”, “2”, or “4”.
Don’t use characters that aren’t alphanumeric such as “#fff000”.
Don’t use only one letter such as R. (For Chinese, Japanese, or Korean languages, you can include a single character such as 红.)
Don’t reference the product or image such as “see image”.
Don’t combine several color names into one word, such as “RedPinkBlue”. Instead, separate them with a /, such as “Red/Pink/Blue”. Don’t use a value that isn’t a color, such as “multicolor”, “various”, “variety”, “men’s”, “women’s”, or “N/A”.
If your product features multiple colors, list the primary color first.
For variants:
- Include the same value for item group ID [item_group_id] and different values for color [color]

Gender [gender]

The gender for which your product is intended

Required (Required for all apparel items that are targeted to people in Brazil, France, Germany, Japan, the UK, and the US as well as all gender-specific products)

Required for free listings for all Google Apparel & Accessories (ID: 166) products

Optional for all other products and target countries

Example
Unisex

Supported values

Male [male]
Female [female]
Unisex [unisex]

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

For some Apparel & Accessories (ID:166) categories like Shoelaces (ID:1856), this attribute is recommended instead of required since these categories aren’t dependent on gender.
For variants:
- Include the same value for item group ID [item_group_id] and different values for gender

Material [material]

Your product’s fabric or material

Required (if relevant for distinguishing different products in a set of variants)

Optional for all other products

Example
leather

Syntax
Max 200 characters

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

To indicate multiple materials for a single product (not variants), add a primary material, followed by up to 2 secondary materials, separated by a /.
- For example, instead of “CottonPolyesterElastane”, use “cotton/polyester/elastane”.
For variants:
- Include the same value for the item group ID [item_group_id] attribute and different values for the material attribute

Pattern [pattern]

Your product’s pattern or graphic print

Required (if relevant for distinguishing different products in a set of variants)

Optional for all other products

Example
striped
polka dot
paisley

Syntax
Max 100 characters

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

For variants:
- Include the same value for the item group ID [item_group_id] attribute and different values for the pattern attribute

Size [size]

Your product’s size

Required (Required for all apparel products in Apparel & Accessories > Clothing (ID:1604) and Apparel & Accessories > Shoes (ID:187) categories targeted to people in Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different sizes)

Required for free listings for all Apparel & Accessories > Clothing (ID:1604) and Apparel & Accessories > Shoes (ID:187) products

Optional for all other products and target countries

Example
XL

Syntax
Max 100 characters

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

For variants:
- Include this with the same value for item group ID [item_group_id] and different values for size [size]
If sizes contain multiple dimensions, condense them into one value. For example, “16/34 Tall” is for neck size of 16 inches, sleeve length of 34 inches, and “Tall” fit
If your item is one size fits all or one size fits most, you can use one_size, OS, one_size fits_all, OSFA, one_size_fits_most, or OSFM.
For merchant-defined multipack products, submit the multipack quantity using the multipack [multipack] attribute. Do not submit the multipack quantity under the size attribute.

Size type [size_type]

Your apparel product’s cut

Optional (Available for apparel products only)

Example
maternity

Supported values

Regular [regular]
Petite [petite]
Maternity [maternity]
Big [big]
Tall [tall]
Plus [plus]

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Submit up to 2 values.
If you don’t submit the attribute, the default value is regular.

Size system [size_system]

The country of the size system used by your product

Optional (Available for apparel products only)

Example
US

Supported values

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

If you don’t submit the attribute, the default value is your target country.

Item group ID [item_group_id]

ID for a group of products that come in different versions (variants)

Required (Brazil, France, Germany, Japan, the United Kingdom, and the US if the product is a variant)

Required for free listings for all product variants

Optional for all other products and target countries

Example
AB12345

Syntax
Max 50 alphanumeric characters

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Use a unique value for each group of variants. Use the parent SKU where possible.
Keep the value the same when updating your product data.
Use only valid unicode characters.
Use an item group ID for a set of products that differ by one or more of these attributes:
Include the same attributes for each product in the item group. For example, if a product varies by size and color, submit size [size] and color [color] for every product that share the same value for item group ID [item_group_id].
If your products differ by design elements that aren’t represented by the attributes above, don’t use item group ID.

Product length [product_length]

Your product’s length

Optional

Example
20 in

Syntax
Number + unit

Supported values
1-3000

Decimal values are supported

Supported units

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include as many of the product measurement attributes as possible.
Use the same unit of measurement for each product dimension attribute (including product length, width, and height). Otherwise, the information won’t be displayed.

Product width [product_width]

Your product’s width

Optional

Example
20 in

Syntax
Number + unit

Supported values
1-3000

Decimal values are supported

Supported units

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include as many of the product measurement attributes as possible.
Use the same unit of measurement for each product dimension attribute (including product lengths, width, and height). Otherwise, the information won’t be displayed.

Product height [product_height]

Your product’s height

Optional

Example
20 in

Syntax
Number + unit

Supported values
1-3000

Decimal values are supported

Supported units

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Include as many of the product measurement attributes as possible.
Use the same unit of measurement for each product dimension attribute (including product lengths, width, and height). Otherwise, the information won’t be displayed.

Product weight [product_weight]

Your product’s weight

Optional

Example
3.5 lb

Syntax
Number + unit

Supported values
0-2000

Decimal values are supported

Supported units

Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)

Use the actual assembled product weight for this attribute.
If your product comes in multiple pieces, for example, as part of a bundle, use the complete weight of all the pieces in the listing.

Product detail [product_detail]

Technical specifications or additional details of your product

Optional

Example
General:Product Type:Digital player

Syntax
This attribute uses 3 sub-attributes:

Section name [section_name]: Max 140 characters
Attribute name [attribute_name]: Max 140 characters
Attribute value [attribute_value]: Max 1000 characters

Schema.org property: No

Don’t add information covered in other attributes, all capital letters, gimmicky foreign characters, promotion text, or list keywords or search terms.
Don’t add information such as price, sale price, sale dates, shipping, delivery date, other time-related information, or your company’s name.
Only provide an attribute name and value when the value is confirmed. For example, provide “Vegetarian=False” if a food product is not vegetarian.

Product highlight [product_highlight]

The most relevant highlights of your products

Optional

Example
Supports thousands of apps, including Netflix, YouTube, and HBO Max

Syntax
Max 150 characters

Schema.org property: No

Use between 2 and 100 product highlights.
Describe only the product itself.
Don’t list keywords or search terms.
Don’t include promotional text, all capital letters, or gimmicky foreign characters.

Source