Notification

In this Help Centre, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure that you're using the article for the Merchant Center version that applies to you. 

Product data specification

A custom icon for Merchant Center Classic and Merchant Center Next.

Use this guide to format your product information for Merchant Center. Google uses this data to make sure that it's matched to the right queries. Sharing your product data in the correct format is important for creating successful ads and free listings for your products.

In this article

Product data attributes:

Before you begin

Other requirements

In addition to this product data specification, your product data must also meet the following requirements:

Formatting your product data

Use English when submitting the names of attributes and the values for attributes that use supported values. For example, the condition [condition] attribute uses the supported values new, refurbished and used, which must be submitted in English in order for the system to read them.

For all attributes that do not use supported values, but rather allow for free-form text, such as the title [title] or description [description] attributes, make sure that you use the same language for all attributes in a feed. Use an underscore when submitting an attribute name with multiple words (for example, image_link). Learn more about how to submit attributes and attribute values

Definitions

  • Product: This is the actual product that potential customers search for on Google.
  • Item: This is a product that has been added to your product data, either in a text feed, XML feed or API. For example, an item is one line in your text feed.
  • Variant: These are specific versions of a product that comes in different variations. For example, a shirt that comes in different sizes has size variants.

Required Required: Submit this attribute. If you don't, your product won't be able to be served in ads and free listings.

This icon represents whether the sourced content is dependent where the product attribute is used It depends: You may or may not need to submit this attribute depending on the product or the countries in which your products are shown.

Optional Optional: You can submit this attribute if you want to help boost your product's performance.

Basic product data

The product information that you submit using these attributes is the foundation for creating successful ads and free listings for your products. Make sure that everything you submit is of the quality that you'd show to a customer.

Attribute and format

Minimum requirements at a glance

ID [id]

Your product's unique identifier

Required Required

Example
A2B4

Syntax
Max. 50 characters

Schema.org property:Yes (Learn more)

  • Use a unique value for each product.
  • Use the product's SKU where possible.
  • Keep the ID the same when updating your data.
  • Use only valid unicode characters.
  • Use the same ID for the same product across countries or languages.

Title [title]

Your product's name

Required Required

Example
Men's Pique Polo Shirt

Syntax
Max. 150 characters

Schema.org property:Yes (Learn more)

  • Accurately describe your product and match the title from your landing page.
  • Don't include promotional text like 'free shipping', all capital letters or gimmicky foreign characters.

For variants:

  • Include distinguishing features such as colour or size.

For mobile devices:

  • Include 'with contract' if sold with a contract.
  • For the United States, include 'with payment plan' if sold in instalments.

For Russia:

  • For books and other information products, include the age rating at the beginning of the title.

Description [description]

Your product's description

Required Required

Example
Made from 100% organic cotton, this classic red men's polo has a slim fit and signature logo embroidered on the left chest. Machine wash cold; imported.

Syntax
Max. 5,000 characters

Schema.org property:Yes (Learn more)

  • Accurately describe your product and match the description from your landing page.
  • Don't include promotional text like 'free shipping', all capital letters or gimmicky foreign characters.
  • Only include information about the product. Don't include links to your shop, sales information, details about competitors, other products or accessories.
  • Use formatting (for example, line breaks, lists or italics) to format your description.

Link [link]

Your product's landing page

Required Required

Example
http://www.example.com/asp/sp.asp?cat=12&id=1030

Schema.org property:Yes (Learn more)

  • Use your verified domain name.
  • Start with http or https.
  • Use an encoded URL that complies with RFC 2396 or RFC 1738.
  • Don't link to an interstitial page unless legally required.

Image link [image_link]

The URL of your product's main image

Required Required

Example
http://www.example.com/image1.jpg

Schema.org property:Yes (Learn more)

For the image URL:

  • Link to the main image of your product.
  • Start with http or https.
  • Use an encoded URL that complies with RFC 2396 or RFC 1738.
  • Make sure that the URL can be crawled by Google (robots.txt configuration allowing Googlebot and Googlebot-image).

For the image:

  • Accurately display the product.
  • Use an accepted format: JPEG (.jpg/.jpeg), WebP (.webp), PNG (.png), non-animated GIF (.gif), BMP (.bmp) and TIFF (.tif/.tiff).
  • Don't scale up an image or submit a thumbnail
  • Don't include promotional text, watermarks or borders.
  • Don't submit a placeholder or a generic image.
  • All images created using generative AI must contain metadata indicating that the image was AI generated (for example, the IPTC Digital Source TypetrainedAlgorithmicMedia metadata tag). Don't remove embedded metadata tags such as the IPTC Digital Source Type property from images created using generative AI tools, for example Project Studio. The following IPTC NewsCodes specify the type of digital source that was used to create the image and should be preserved:

    • TrainedAlgorithmicMedia: The image was created using a model derived from sampled content.
    • CompositeSynthetic: The image is a composite that includes synthetic elements.
    • AlgorithmicMedia: The image was created purely by an algorithm not based on any sampled training data (for example, an image created by software using a mathematical formula).

Additional image link [additional_image_link]

The URL of an additional image for your product

Optional Optional

Example
http://www.example.com/image1.jpg

Syntax
Max. 2,000 characters

Schema.org property: No

  • Meet the requirements for the image link [image_link] attribute with these exceptions:
    • The image can include product staging and show the product in use.
    • Graphics or illustrations can be included.
  • Submit up to 10 additional product images by including this attribute multiple times.
  • All images created using generative AI must contain metadata indicating that the image was AI generated (for example, the IPTC Digital Source TypetrainedAlgorithmicMedia metadata tag). Don't remove embedded metadata tags such as the IPTC Digital Source Type property from images created using generative AI tools, for example Project Studio. The following IPTC NewsCodes specify the type of digital source that was used to create the image and should be preserved:

    • TrainedAlgorithmicMedia: The image was created using a model derived from sampled content.
    • CompositeSynthetic: The image is a composite that includes synthetic elements.
    • AlgorithmicMedia: The image was created purely by an algorithm not based on any sampled training data (for example, an image created by software using a mathematical formula).

3D model link [virtual_model_link]

Additional link to show a 3D model of your product.

Optional Optional (available only in the US)

Note: This attribute is only available in the classic experience of Merchant Center

Example
https://www.google.com/products/xyz.glb

Syntax/type

URL (Must start with 'http://' or 'https://')

Up to 2,000 characters

  • Use a 3D model. Your file shouldn't exceed 15 MB. Textures in the file can be up to 2K (4K isn't supported).
  • Provide a valid URL in your product data. The link should point to a .gltf or .glb file.
  • Review your 3D model. You can use a validation tool to verify if your 3D model works properly.

Mobile link [mobile_link]

Your product's mobile-optimised landing page when you have a different URL for mobile and desktop traffic

Optional Optional

Example
http://www.m.example.com/asp/ sp.asp?cat=12 id=1030

Syntax
Max. 2,000 alphanumeric characters

Schema.org property: No

  • Meet the requirements for the link [link] attribute.

Price and availability

These attributes define the price and availability for your products. This information is shown to potential customers in ads and free listings. If your products' prices and availability change often, you'll need to let us know in order to show your products. Check out these tips for keeping your product information fresh

Attribute and format

Minimum requirements at a glance

Availability [availability]

Your product's availability

Required Required

Example
in_stock

Supported values

  • In stock [in_stock]
  • Out of stock [out_of_stock]
  • Pre-order [preorder]
  • Backorder [backorder]

Schema.org property: Yes (Learn more)

  • Accurately submit the product's availability and match the availability with your landing page and checkout pages.
  • Provide the availability date [availability_date] attribute (with a value up to one year in the future) if the availability is set to pre-order.

Availability date [availability_date]

Required Required if product availability is set to pre-order

The date a pre-ordered product becomes available for delivery

Example
(for UTC+1)
2016-02-24T11:07+0100

Syntax

  • Max. 25 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ

Schema.org property: Yes (Learn more)

  • Use this attribute if your product's availability is set to pre-order. Provide a value up to one year in the future.
  • The availability date should also be added to the product's landing page and be clear to your customers (for example, '6 May 2023').
    • If an exact date can't be provided, you can use an estimated date (for example, 'May 2023').

Cost of goods sold [cost_of_goods_sold]

Your product's description

Optional Optional

The costs associated with the sale of a particular product as defined by the accounting convention that you've set up. These costs may include material, labour, freight or other overhead expenses. By submitting the COGS for your products, you gain insights about other metrics, such as your gross margin and the amount of revenue generated by your ads and free listings.

Example
23.00 GBP

Syntax

  • ISO 4217 codes
  • Use '.' rather than ',' to indicate a decimal point
  • Numeric

Schema.org property: No

  • The currency must be in the ISO 4217 format. For example, GBP for British pounds.
  • The decimal point must be a period (.). For example, 10.00 GBP.

Expiry date [expiration_date]

The date that your product should stop being shown

Optional Optional

Example
(for UTC+1)
2016-07-11T11:07+0100

Syntax

  • Max. 25 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ

Schema.org property: No

  • Use a date less than 30 days in the future.
  • Note that a latency of several hours may occur.

Price [price]

Your product's price

Required Required

Example
15 USD

Syntax

  • Numeric
  • ISO 4217

Schema.org property: Yes (Learn more)

  • Accurately submit the product's price and currency, and match with the price from your landing page and at checkout.
  • Make sure that your landing page and the checkout pages include the price in the currency of the target country in a place that's straightforward to find.
  • Ensure that the product can be purchased online for the submitted price.
  • Make sure that any customer in the target country can buy the product for the submitted price, and without paying for a membership.
  • Don't submit a price of 0 (a price of 0 is allowed for mobile devices sold with a contract).
  • For products sold in bulk quantities, bundles or multipacks.
    • Submit the total price of the minimum purchasable quantity, bundle or multipack.
  • For the US and Canada:
    • Don't include tax in the price.
  • For all other countries:
    • Include Value Added Tax (VAT) or goods and services tax (GST) in the price.
  • For additional options to submit price-related information, see the following attributes:
    • Unit pricing measure [unit_pricing_measure]
    • Unit pricing base measure [unit_pricing_base_measure]
    • Sale price [sale_price]
    • Subscription cost [subscription_cost]
    • Instalment [installment]

Sale price [sale_price]

Your product's sale price

Optional Optional

Example
15 USD

Syntax

  • Numeric
  • ISO 4217

Schema.org property: No

  • Meet the requirements for the price [price] attribute.
  • Submit this attribute (sale price) in addition to the price [price] attribute set to the non-sale price.
  • Accurately submit the product's sale price and match the sale price with your landing page and the checkout pages.

Sale price effective date
[sale_price_effective_date]

The date range during which the sale price applies

Optional Optional

Example
(for UTC+1)
2016-02-24T11:07+0100 /
2016-02-29T23:07+0100

Syntax

  • Max. 51 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ
  • Separate start date and end date with /

Schema.org property: No

  • Use together with the sale price [sale_price] attribute.
  • If you don't submit this attribute (sale price effective date), the sale price always applies.
  • Use a start date before the end date.

Unit pricing measure
[unit_pricing_measure]

The measure and dimension of your product as it is sold

Optional Optional (except when required by local laws or regulations)

Example
1.5 kg

Syntax
Numerical value + 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

Schema.org property: Yes (Learn more)

  • Use the measure or dimension of the product without packaging.
  • Use a positive number.
  • For variants:
    • Include the same value for item group ID [item_group_id] and different values for unit pricing measure.

Unit pricing base measure
[unit_pricing_base_measure]

The product's base measure for pricing (for example, 100 ml means that the price is calculated based on a unit of 100 ml)

Optional Optional (except when required by local laws or regulations)

Example
100 g

Syntax
Integer + unit

Supported integers
1, 10, 100, 2, 4, 8

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

Additional supported metric integer + unit combinations
75 cl, 750 ml, 50 kg, 1000 kg

Schema.org property: Yes (Learn more)

  • Optional when you submit the unit pricing measure [unit_pricing_measure] attribute.
  • Use the same unit of measure for this attribute (unit pricing measure) and unit pricing base measure.
  • Bear in mind that the price (or sale price, if active) is used to calculate the unit price of the product. For example, if the price [price] attribute is set to 3 USD, unit pricing measure is 150 ml and unit pricing base measure is set to 100 ml, then the unit price is 2 USD/100 ml.

Instalment [installment]

Details of an instalment payment plan

Optional Optional (available in Latin America for all product categories and in certain other countries for showing wireless products and services only)

Example
6.50 BRL

Syntax
This attribute uses two sub-attributes:

  • Months [months] (required)
    Integer, the number of instalments that the buyer has to pay.
  • Amount [amount] (required)
    ISO 4217, the amount that the buyer has to pay per month

Schema.org property: No

  • Match the instalment option that's visible on your landing page.
  • Don't require a loyalty card.
  • For Latin America, make sure that the price [price] attribute is the total price when paid in full upfront and use the instalment [installment] attribute to indicate an alternative payment option using instalments.
  • For other countries, use the price [price] attribute (as low as 0) as the upfront payment (including any device down payment and activation fees) and the instalment [installment] attribute for additional monthly instalment payments.

Subscription cost [subscription_cost]

Details a monthly or annual payment plan that bundles a communications service contract with a wireless product

Optional Optional (available in certain countries for showing wireless products and services only)

Example
month:12:35.00GBP

Syntax

  • Period [period] (required)
    The duration of a single subscription period. This sub-attribute uses the following supported values:
    • Month [month]
    • Year [year]
  • Period length [period_length] (required)
    Integer, the number of subscription periods (months or years) that the buyer must pay.

  • Amount [amount] (required)
  • ISO 4217, the amount that the buyer must pay per month. When displaying this amount, Google may round up to the nearest whole unit of local currency to save space. The provided value must still exactly match the amount as shown on your site.

Schema.org property: No

  • Submit the price [price] attribute with the total amount due at checkout (including deposit and activation fee).

  • Match the communications payment plan that you display on your landing page. The plan must be easy to find on the landing page.

Loyalty points [loyalty_points]

The number and type of loyalty points that a customer receives when buying a product

Optional Optional (available for Japan only)

Example
Programme A, 100, 1.5

Syntax
This attribute uses three sub-attributes:

  • Loyalty point value [points_value] (required)
    Number of points earned for the product
  • Loyalty points programme name [name] (optional)
    Name of the loyalty points programme, 12 full-width characters or 24 roman characters
  • Ratio [ratio] (optional)
    Number, the ratio of a point when converted to currency

Schema.org property: No

  • Only submit loyalty points with a specific monetary value.

Product category

You can use these attributes to organise your advertising campaigns in Google Ads and to override Google's automatic product categorisation in specific cases.

Attribute and format Minimum requirements at a glance

Google product category [google_product_category]

Optional Optional

Google-defined product category for your product

Example
Clothing and accessories > Clothing > Outerwear > Coats and jackets

or

371

Syntax
Value from the Google product taxonomy

  • The numerical category ID, or
  • The full path of the category

Supported values

Google product taxonomy

Schema.org property

No

  • Include only one category.
  • Include the most relevant category.
  • Include either the full path of the category or the numerical category ID, but not both. It is recommended that you use the category ID.
  • Include a specific category for certain products.
    • Alcoholic beverages must be submitted only to certain categories.
  • Mobile devices sold with contract must be submitted as either:
    • Electronics > Communications > Telephony > Mobile phones (ID: 267

    • For tablets: Electronics > Computers > Tablet computers (ID: 4745)

  • Gift cards must be submitted as Arts and entertainment > Party and celebration > Gift giving > Gift cards and certificates (ID: 53)

Product type [product_type]

Optional Optional

Product category that you define for your product

Example
Home > Women > Dresses > Maxi dresses

Syntax
Max. 750 alphanumeric characters

Schema.org property

No

  • Include the full category. For example, include Home > Women > Dresses > Maxi dresses instead of just Dresses
  • Only the first product type value will be used to organise bidding and reporting in Google Ads Shopping campaigns

Product identifiers

These attributes are used to provide product identifiers that define the products that you're selling in the global marketplace and can help boost the performance of your ads and free listings.

Attribute and format Minimum requirements at a glance

Brand [brand]

Your product's brand name

Required Required (For all new products, except films, books and musical recording brands)

Optional Optional for all other products

Example
Google

Syntax
Max. 70 characters

Schema.org property

Yes 

Learn more

  • Provide the brand name of the product generally recognised by consumers.
  • Providing the correct brand for a product will ensure the best user experience and result in the best performance.
  • Only provide your own brand name as the brand if you manufacture the product or if your product falls into a generic brand category.
    • For example, you could submit your own brand name as the brand if you sell private-label products or customised jewellery.
  • For products that truly do not have a brand (e.g. a vintage dress without a label, generic electronics accessories, etc.), leave this field empty.
  • Don't submit values such as 'N/A', 'Generic', 'No brand' or 'Does not exist'.
  • For compatible products:
    • Submit the GTIN and brand from the manufacturer who actually built the compatible product.
    • Don't provide the original equipment manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand's product.

GTIN [gtin]

Your product's Global Trade Item Number (GTIN)

Required Required (For all products with a known GTIN to enable full offer performance)

Optional Optional (strongly recommended) for all other products

Example
3234567890126

Syntax
Max. 50 numeric characters (max. 14 per value – added spaces and dashes are ignored)

Supported values

  • UPC (in North America/GTIN-12)
    12-digit number like 323456789012
    8-digit UPC-E codes should be converted to 12-digit codes
  • EAN (in Europe/GTIN-13)
    13-digit number like 3001234567892
  • JAN (in Japan/GTIN-13)
    8- or 13-digit number like 49123456 or 4901234567894
  • ISBN (for books)
    10- or 13-digit number like 1455582344 or 978-1455582341. If you have both, only include the 13-digit number. ISBN-10 is deprecated and should be converted to ISBN-13
  • ITF-14 (for multipacks/GTIN-14)
    14-digit number like 10856435001702

Schema.org property

Yes 

Learn more

  • Exclude dashes and spaces.
  • Submit only valid GTINs as defined in the official GS1 validation guide, which includes these requirements:
    • The checksum digit is present and correct
    • The GTIN is not restricted (GS1 prefix ranges 02, 04, 2)
    • The GTIN is not a coupon (GS1 prefix ranges 98–99)
  • Providing the correct GTIN for a product will ensure the best user experience and result in the best performance.
  • Only provide a GTIN if you're sure that it is correct. When in doubt don't provide this attribute (e.g. do not guess or make up a value). If you submit a product with an incorrect GTIN value, your product will be disapproved.
  • For compatible products:
    • Submit the GTIN and brand from the manufacturer who actually built the compatible product.
    • Don't provide the original equipment manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand's product.
  • For multipacks:
    • Use the product identifier that relates to the multipack.
  • For bundles:
    • Use the product identifier for the main product in the bundle.
  • If you offer customisation, engraving or other personalisation of a product that's been assigned a GTIN by the manufacturer:
    • Submit the GTIN and use the bundle [is_bundle] attribute to let Google know that the product includes customisation.

MPN [mpn]

Your product's manufacturer part number (MPN)

Required Required (Only if your product does not have a manufacturer-assigned GTIN)

Optional Optional for all other products

Example
GO12345OOGLE

Syntax
Max. 70 alphanumeric characters

Schema.org property

Yes 

Learn more

  • Only submit MPNs assigned by a manufacturer.
  • Use the most specific MPN possible.
    • For example, different colours of a product should have different MPNs.
  • Providing the correct MPN for a product (when required) will ensure the best user experience and result in the best performance.
  • Only provide an MPN if you're sure that it's correct. When in doubt, don't provide this attribute (e.g. don't guess or make up a value).
  • If you submit a product with an incorrect MPN value, your product will be disapproved.

Identifier exists [identifier_exists]

Use to indicate whether or not the unique product identifiers (UPIs) GTIN, MPN and brand are available for your product.

Optional Optional

Example
no

Supported values

  • Yes [yes]
    Product identifiers are assigned to the new product by the manufacturer
  • No [no]
    Product lacks a brand, GTIN or MPN (see requirements to the right). If set to no [no], still provide the UPIs that you have.

Schema.org property

No

  • If you don't submit the attribute, the default value is yes.
  • Your product's category type determines which unique product identifiers (GTIN, MPN, brand) are required.
  • Submit the identifier exists attribute and set the value to no [no] if:
    • Your product is a media item and the GTIN is unavailable (Note: ISBN and SBN codes are accepted as GTINs
    • Your product is a clothing item and the brand is unavailable
    • In all other categories, your product doesn't have a GTIN or a combination of MPN and brand
  • If a product does have unique product identifiers, don't submit this attribute with a value of 'no' or the product may be disapproved.

Detailed product description

These attributes are used to provide product identifiers that define the products that you're selling in the global marketplace and can help boost the performance of your ads and free listings. 

Attribute and format Minimum requirements at a glance

Condition [condition]

The condition of your product at time of sale

Required Required if your product is used or refurbished

Optional 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)

 

Adult [adult]

Indicate that a product includes sexually suggestive content

Required Required (If a product contains adult content)

Example
yes

Supported values

  • Yes [yes]
  • No [no]

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 noLearn 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.
  • If you use Merchant Center Next, find these settings in the Business details tab.
  • If you use the classic Merchant Center, find these settings under 'Tools and settings' and then select 'Account'.

Multipack [multipack]

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

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

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

Optional 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 six 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 that a product is a merchant-defined custom group of different products featuring one main product

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

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

Optional Optional for all other products and target countries

Example
yes

Supported values

  • Yes [yes]
  • No [no]

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 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 labelling regulations

Optional  Optional for all other products

Example

EC:EPREL:123456

Syntax

This attribute uses the following sub-attributes:

  • Authority [authority] The certification authority. Only 'EC' or 'European_Commission' are supported.
  • Name [name] The name of the certification. Only 'EPREL' is supported.
  • Code [code] The certification code. 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 rescaled EU energy labels, for example:

  • Fridges and freezers
  • Dishwashers 
  • Televisions and other external monitors
  • Household washing machines and washer-dryers
  • Refrigerating appliances with a direct-sales function
  • Light sources

For products that haven't been rescaled or can't be located in the EU EPREL database, you can use the energy efficiency class [energy_efficiency_class], minimum energy efficiency class [min_energy_efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] attributes.

Energy efficiency class [energy_efficiency_class]

Your product's energy label

Available for the EU and EFTA countries and the UK

Optional Optional (except when required by local law or regulations)

Example
A+

Supported values

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

Schema.org property: Yes (Learn more)

  • Include the legally required energy label.
  • 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]

Your product's energy label

Available for the EU and EFTA countries and the UK

Optional Optional (except when required by local laws or regulations)

Available for EU and CH only

Example
A+++

Supported values

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

Schema.org property: Yes (Learn more)

  • Include the legally required energy label.
  • 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]

Your product's energy label

Available for the EU and EFTA countries and the UK

Optional Optional (except when required by local laws or regulations)

Available for EU and CH only

Example
D

Supported values

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

Schema.org property: Yes (Learn more)

  • Include the legally required energy label
  • To be used in combination with energy efficiency class [energy_efficiency_class] and maximum energy efficiency class [max_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 Required (For all clothing products that are targeted at people in Brazil, France, Germany, Japan, the UK, and the US as well as all products with assigned age groups)

Required Required for free listings for all Clothing and accessories (ID: 166) products

Optional 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
  • Children [kids]
    5–13 years old
  • Adult [adult]
    Teenagers or older

Schema.org property: Yes (Learn more)

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

Colour [color]

Your product's colour(s)

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

Required Required for free listings for all Clothing and accessories (ID: 166) products

Optional Optional for all other products and target countries

Example
black

Syntax
Max. 100 alphanumeric characters (max. 40 characters per colour)

Schema.org property: Yes (Learn more)

  • 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 colour 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 colour, such as 'multicolour', 'various', 'variety', 'men's', 'women's' or 'N/A'.
  • If your product features multiple colours, list the primary colour first.
  • For variants:
    • Include the same value for item group ID [item_group_id] and different values for colour [color]

Gender [gender]

The gender for which your product is intended

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

Required Required for free listings for all Google Clothing and accessories (ID: 166) products

Optional Optional for all other products and target countries

Example
unisex

Supported values

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

Schema.org property: Yes (Learn more)

  • For some clothing and accessories (ID:166) categories like shoelaces (ID:1856), this attribute is recommended instead of required as 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 Required (if relevant for distinguishing different products in a set of variants)

Optional Optional for all other products

Example
leather

Syntax
Max. 200 characters

Schema.org property: Yes (Learn more)

  • To indicate multiple materials for a single product (not variants), add a primary material, followed by up to two 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 Required (if relevant for distinguishing different products in a set of variants)

Optional Optional for all other products

Example
striped
polka dot
paisley

Syntax
Max. 100 characters

Schema.org property: Yes (Learn more)

  • 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 (Required for all clothing products in Clothing and accessories > Clothing (ID:1604) and Clothing and accessories > Shoes (ID:187) categories targeted at people in Brazil, France, Germany, Japan, the UK and the US as well as all products available in different sizes)

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

Optional Optional for all other products and target countries

Example
XL

Syntax
Max. 100 characters

Schema.org property: Yes (Learn more)

  • 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 clothing product's cut

Optional Optional (Available for clothing products only)

Example
maternity

Supported values

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

Schema.org property: Yes (Learn more)

  • Submit up to two 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 Optional (Available for clothing products only)

Example
US

Supported values

  • US
  • UK
  • EU
  • DE
  • FR
  • JP
  • CN
  • IT
  • BR
  • MEX
  • AU

Schema.org property: Yes (Learn more)

  • 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 Required (Brazil, France, Germany, Japan, the United Kingdom and the US if the product is a variant)

Required Required for free listings for all product variants

Optional Optional for all other products and target countries

Example
AB12345

Syntax
Max. 50 alphanumeric characters

Schema.org property: Yes (Learn more)

 

Product length [product_length]

Your product's length

Optional Optional

Example
20 in

Syntax
Number + unit

Supported values
1–3000

  • Decimal values are supported

Supported units

  • cm
  • in

Schema.org property: Yes (Learn more)

  • 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 Optional

Example
20 in

Syntax
Number + unit

Supported values
1–3000

  • Decimal values are supported

Supported units

  • cm
  • in

Schema.org property: Yes (Learn more)

  • 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 height [product_height]

Your product's height

Optional Optional

Example
20 in

Syntax
Number + unit

Supported values
1–3000

  • Decimal values are supported

Supported units

  • cm
  • in

Schema.org property: Yes (Learn more)

  • 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 weight [product_weight]

Your product's weight

Optional Optional

Example
3.5 lb

Syntax
Number + unit

Supported values
0–2000

  • Decimal values are supported

Supported units

  • lb
  • oz
  • g
  • kg

Schema.org property: Yes (Learn more)

  • 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 of the pieces in the listing.

Product detail [product_detail]

Technical specifications or additional details of your product

Optional Optional

Example
General:Product Type:Digital player

Syntax
This attribute uses three sub-attributes:

  • Section name [section_name]: Max. 140 characters
  • Attribute name [attribute_name]: Max. 140 characters
  • Attribute value [attribute_value]: Max. 1,000 characters

Schema.org property: No

  • Don't add information covered in other attributes, all capital letters, gimmicky foreign characters or promotion text, or list keywords or search terms.
  • Don't add information such as price, sale price, sale dates, delivery, 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 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.

Shopping campaigns and other configurations

These attributes are used to control how your product data is used when you create advertising campaigns in Google Ads.

Attribute and format Minimum requirements at a glance

Ads redirect [ads_redirect]

A URL used to specify additional parameters for your product page. Customers will be sent to this URL rather than the value that you submit for the link [link] or mobile link [mobile_link] attributes

Optional Optional

Example
http://www.example.com/product.html

Syntax
Max. 2,000 characters

Schema.org property: No

  • Submit the same registered domain as for the link [link]attribute (and the mobile link [mobile_link]attribute, if present).
  • Valid registered domains include 'example.com', 'm-example.com', 'example.co.uk', 'example.com.ai' and 'bar.tokyo.jp'.
  • URLs submitted with invalid domains, such as 'example.zz' or 'example.comic', will not be accepted. For more details on valid registered domains, see ads redirect.

Custom label 0–4 [custom_label_0–4]

Label that you assign to a product to help organise bidding and reporting in Shopping campaigns

Optional Optional

Example
Seasonal 
Clearance
Christmas
Sale
Price range

Syntax
Max. 100 characters

Schema.org property: No

  • Use a value that you'll recognise in your Shopping campaign. The value won't be shown to customers who see your ads and free listings.
  • Submit up to five custom labels per product by including this attribute multiple times:
    • custom_label_0 [custom_label_0]
    • custom_label_1 [custom_label_1]
    • custom_label_2 [custom_label_2]
    • custom_label_3 [custom_label_3]
    • custom_label_4 [custom_label_4]
  • Use only 1,000 unique values for each custom label across your Merchant Center account.

Promotion id [promotion_id]

An identifier that allows you to match products to promotions

Optional Optional (Required for promotions in Australia, France, Germany, India, the UK and the US)

Example
ABC123

Syntax
Max. 50 characters

Schema.org property: No

  • Use a unique and case-sensitive ID without spaces or symbols (for example %, !).
  • To map specific promotions to specific products, submit the same promotion ID in your product data and promotion data.
  • Submit up to 10 promotion IDs for one product by including this attribute multiple times.

Lifestyle image link [lifestyle_image_link]

Optional Optional

Attribute used to include the URL for a lifestyle image for your product

Only available for browsy surfaces, such as Discovery ads

Example

https://www.example.com/image1.jpg

Syntax

Max. 2,000 characters

Schema.org property: No

  • Use a URL that points to an image in a supported file format
  • Start with http or https and comply with RFC 3986
  • Replace any symbols or spaces with URL encoded entities
  • Make sure that Google can crawl your URL
  • All images created using generative AI must contain metadata indicating that the image was AI generated (for example, the IPTC Digital Source TypetrainedAlgorithmicMedia metadata tag). Don't remove embedded metadata tags such as the IPTC Digital Source Type property from images created using generative AI tools, for example Project Studio. The following IPTC NewsCodes specify the type of digital source that was used to create the image and should be preserved:

    • TrainedAlgorithmicMedia: The image was created using a model derived from sampled content.
    • CompositeSynthetic: The image is a composite that includes synthetic elements.
    • AlgorithmicMedia: The image was created purely by an algorithm not based on any sampled training data (for example, an image created by software using a mathematical formula).

Marketplaces

These attributes are used to control how your product data is used if you are a marketplace and are using a multi-seller account.

Note: Marketplaces is currently only available in the classic version of Merchant Center.

Attributes and format Requirements at a glance

External seller ID [external_seller_id]

Note: Marketplaces is currently only available in the classic version of Merchant Center.Required for multi-seller account

Used by a marketplace to externally identify a seller. (For example, on a website)

Example

SellerPublicName1991

Syntax

1–50 characters

Schema.org property: No

  • Use a unique value for each seller.
  • Keep the ID the same when updating your data
  • Use only valid characters. Avoid invalid characters like control, function or private area characters
  • Use the same ID for the same seller across countries or languages

Destinations

These attributes can be used to control the different locations where your content can appear. For example, you could use this attribute if you want a product to appear in a dynamic remarketing campaign, but not in a Shopping ads campaign.

Attributes and format Requirements at a glance

Excluded destination [excluded_destination]

A setting that you can use to exclude a product from participating in a specific type of advertising campaign

Optional Optional

Example
Shopping_ads

Supported values

  • Shopping_ads
  • Buy_on_Google_listings
  • Display_ads
  • Local_inventory_ads
  • Free_listings
  • Free_local_listings
  • YouTube_Shopping

Some values only available for the classic version of Merchant Center.

Schema.org property: No

 

Included destination [included_destination]

A setting that you can use to include a product in a specific type of advertising campaign

Optional Optional

Example
Shopping_ads

Supported values

  • Shopping_ads
  • Buy_on_Google_listings
  • Display_ads
  • Local_inventory_ads
  • Free_listings
  • Free_local_listings
  • YouTube_Shopping

Some values only available for the classic version of Merchant Center.

Schema.org property: No

 

Excluded countries for Shopping ads [shopping_ads_excluded_country]

A setting that allows you to exclude countries where your products are advertised on Shopping ads

Optional Optional

Only available for Shopping ads

Example
DE

Syntax
2 characters. Must be an ISO 3166-1 alpha-2 country code.

Schema.org property: No

 

Pause [pause]

A setting that you can use to pause and quickly reactivate a product for all ads (including Shopping ads, display ads and local inventory ads). A product can be paused for up to 14 days. If a product is paused for more than 14 days, it will be disapproved. To reapprove, remove the attribute.

Optional Optional

Example
ads

Supported values
ads

Schema.org property: No

 

 

Delivery

These attributes can be used together with the account delivery settings and return settings to help you provide accurate delivery and return costs. People who are shopping online rely on delivery costs and speeds, as well as return policies, to help them make choices about what to buy, so it's important to take the time to submit quality information. 

Attribute and format Minimum requirements at a glance

Delivery [shipping]

Your product's delivery cost, delivery speeds and the locations that your product delivers to

This icon represents whether the sourced content is dependent where the product attribute is used It depends

Required Delivery costs are required for Shopping ads and free listings for the following countries: Australia, Austria, Belgium, Canada, Czechia, France, Germany, Ireland, Israel, Italy, Japan, the Netherlands, Poland, Romania, South Korea, Spain, Switzerland, the UK and the US

You may also be required to provide delivery costs based on local laws or regulations.

Optional Optional (to specify additional countries your product delivers to or destinations where delivery costs are not required)

Supported prices
0–1000 USD (check for other currencies)

Example
US:CA:Overnight:16.00 USD:1:1:2:3

Syntax
This attribute uses the following sub-attributes:

  • Country [country] (required)
    ISO 3166 country code
  • Region [region](optional)
  • Postcode [postal_code](optional)
  • Location ID [location_id] (optional)
  • Location group name [location_group_name] (optional)
  • Service [service] (optional)
    Service class or delivery speed
  • Price [price] (optional)
    Fixed delivery cost, including VAT if required
  • Minimum handling time [min_handling_time] and maximum handling time [max_handling_time] (optional)
    To specify handling time
  • Minimum transit time [min_transit_time] and maximum transit time [max_transit_time] (optional)
    To specify transit time

Schema.org property: Yes (Learn more)

  • Use this setting when delivery costs for your product are not defined in your Merchant Center account or when you need to override delivery costs or speeds defined in your Merchant Center account.

Delivery label [shipping_label]

Optional Optional

Label that you assign to a product to help assign correct delivery costs in your Merchant Center account settings

Example

perishable

Syntax

Max 100 characters

Schema.org property: No

  • Use a value that you'll recognise in your account delivery settings. The value won't be shown to customers. Examples:
    • Same day
    • Oversized
    • Only FedEx

Delivery weight [shipping_weight]

The weight of the product used to calculate the delivery cost

Optional Optional (Required for carrier-calculated rates in your account delivery settings)

Supported weights

  • 0–2000 lbs for imperial
  • 0–1000 kg for metric

Example
3 kg

Syntax
Number + unit

Supported units

  • lb
  • oz
  • g
  • kg

Schema.org property: No

  • Submit this value if you set up account delivery settings for carrier-calculated rates or weight-based delivery services

Delivery length [shipping_length]

The length of the product used to calculate the delivery cost by dimensional weight

Optional Optional (Required for carrier-calculated rates in your account delivery settings)

Example
20 in

Syntax
Number + unit

Supported values

  • 1–150 for inches
  • 1–400 for cm

Supported units

  • in.
  • cm

Schema.org property: No

  • Submit this value if you set up account delivery settings for carrier-calculated rates.
  • If you don't provide delivery dimension attributes while using carrier-calculated rates, Google won't be able to calculate rates based on the dimensional weight of the product. If that's the case, we'll just calculate the rates based on the value that you provided in the delivery weight [shipping_weight] attribute.
  • If you submit this attribute, submit all delivery dimension attributes:
    • Delivery length [shipping_length]
    • Delivery width [shipping_width]
    • Delivery height [shipping_height]
  • Use the same unit for all delivery dimension attributes that apply to a single product.
  • Google doesn't automatically calculate additional delivery cost for oversized products. If your package would be considered large or oversized by your carrier, you should use the delivery [shipping] attribute to set the delivery cost for an individual product.

Delivery width [shipping_width]

The width of the product used to calculate the delivery cost by dimensional weight

Optional Optional (Required for carrier-calculated rates in your account delivery settings)

Example
20 in

Syntax
Number + unit

Supported values

  • 1–150 for inches
  • 1–400 for cm

Supported units

  • in.
  • cm

Schema.org property: No

  • Meet the requirements for the delivery length [shipping_length] attribute.

Delivery height [shipping_height]

The height of the product used to calculate the delivery cost by dimensional weight

Optional Optional (Required for carrier-calculated rates in your account delivery settings)

Example
20 in

Syntax
Number + unit

Supported values

  • 1–150 for inches
  • 1–400 for cm

Supported units

  • in.
  • cm

Schema.org property: No

  • Meet the requirements for the delivery length [shipping_length] attribute.

Dispatched from country [ships_from_country]

A setting that allows you to provide the country from which your product will typically be dispatched

Optional Optional

Example
DE

Syntax
two characters. Must be an ISO_3166-1_alpha-2 country code.

Schema.org property: No

  • Provide only the country from which you typically dispatch this product.

Maximum handling time [max_handling_time]

The longest amount of time between when an order is placed for a product and when the product is dispatched

Optional Optional

Example
3

Syntax
Integer, greater than or equal to 0

Schema.org property: No

  • Submit this attribute if you want to display the overall time that it takes for a product to arrive at its destination.
  • Submit the number of working days (as configured in Merchant Center).
  • For products ready to be dispatched the same day, submit 0.
  • For submitting a time range, submit maximum handling time [max_handling_time] in combination with minimum handling time [min_handling_time].

Transit time label [transit_time_label]

Optional Optional

Label that you assign to a product to help assign different transit times in Merchant Center account settings.

Example

From Seattle

Syntax

Max 100 characters

Schema.org property: No

 

Minimum handling time [min_handling_time]

The shortest amount of time between when an order is placed for a product and when the product is dispatched

Optional Optional

Example
1

Syntax
Integer, greater than or equal to 0

Schema.org property: No

  • Meet the requirements for the maximum handling time [max_handling_time] attribute.

Tax

These attributes can be used together with the account tax settings to help you provide accurate tax costs.

Format Minimum requirements at a glance

Tax [tax]

Your product's sales tax rate as a percentage

Required Required (Available for the US only)

Example
US:CA:5.00:y

Syntax
This attribute uses four sub-attributes:

  • Country [country] (optional)
    ISO 3166 country code
  • Region [region] or postcode [postal_code] or location ID [location_id] (optional)
  • Rate [rate] (required)
    Tax rate as a percentage
  • Delivery tax [tax_ship] (optional)
    Specify if you charge tax on delivery.
    • Supported values:
      • yes or no

Schema.org property

No

  • Use this setting only to override the account tax settings for an individual product. We recommend that you submit tax information for all your products using the account settings in Merchant Center.
  • For the US and Canada:
    • Don't include tax in the price [price] attribute.
  • For the US only, include the tax in the tax [tax] attribute if you need to override your account settings.
  • For all other countries:
    • Include Value Added Tax (VAT) or goods and services tax (GST) in the price attribute and do not use the tax attribute.

Tax category [tax_category]

A category that classifies your product by specific tax rules

Optional Optional (Recommended for custom tax rates at the account level)

Example
Clothing

Syntax
Max. 100 characters

Schema.org property

No

  • Use this attribute if you have products that have a specific tax rate.
  • Category labels in your product data must match the labels that you enter in the Categories section in Merchant Center.

Was this helpful?

How can we improve it?
true
Search
Clear search
Close search
Google apps
Main menu
10698395902152509361
true
Search Help Centre
true
true
true
true
true
71525
false
false