Product data specification

Use this specification to format your product information for Merchant Center programs, such as Shopping ads, free product listings, and Buy on Google. Submitting your product data to Google in the correct format is important for creating successful ads and free listings for your products. We use this data to make sure that it's matched to the right queries.

Before you begin

If you're new to Merchant Center, get started with the onboarding guide.

Other requirements to keep in mind

Google also has a few other requirements that your product data needs to meet. Get familiar with them before you begin:

• Shopping ads policies
• Landing page requirements
• Tax rate data requirements
• Shipping rate data requirements
• Checkout requirements and best practices
• Currency and language requirements. Submit attributes and values using a supported language and currency for the country you'd like to advertise to and the format you've chosen.
  • Delimited format. Use any supported language for the name of the attribute and fixed attributes values, e.g. the condition attribute has the fixed value new. Make sure to use the language of the country of sale for any attribute value without a fixed value, e.g. title. Use an underscore or space within an attribute name (e.g., image_link or image link)
  • XML or API. Use attribute names in English only (the version not in brackets). Use an underscore to represent a space within an attribute name (e.g., image_link instead of image link). A space within an attribute value is allowed (e.g., in stock).

Additional product data specifications

If you want to list products in free product listings, show products in local inventory ads or promotions, or sell products through Buy on Google, you may need to submit supplemental attributes and different requirements may apply. Use each feature’s specifications alongside this specification to submit the correct data:

• Buy on Google product data specification
• Local inventory ads product data specification
• Promotions product data specification
• Data and eligibility requirements to show your products for free on Google

Definitions

• Product. Word that describes the actual product that your potential customers would be searching for on Google.
• Item. Word that describes a product once it's 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. Word that describes a product that comes in different variations. For example, a shirt that comes in different sizes has size variants.

Quick reference

	Required	Submit this attribute. If you don't, your product won't be able to serve in ads and free listings.
	It depends	Check the attribute's related article to understand if you need to submit this attribute for your products. Sometimes the requirements change depending on which countries your products show in.
	Optional	You can submit this attribute if you want to help boost your product's performance.

Attributes		Common product categories
Group	Attribute name	Apparel & accessories	Media (books, movies, musical recordings)	Software	Variant products	All other product types
Basic product data	id
	title
	description
	link
	image_link
	additional_ image_link
	mobile_link
Price & availability	availability
	availability_date
	expiration_date
	price
	sale_price
	sale_price_ effective_date
	cost_of_goods_sold
	unit_pricing_measure
	unit_pricing_ base_measure
	installment
	subscription_cost
	loyalty_points
Product category	google_product_ category
	product_type
Product identifiers	brand
	gtin
	mpn
	identifier_exists
Detailed product description	condition
	adult
	multipack
	is_bundle
	energy_ efficiency_class
	min_energy_ efficiency_class
	max_energy_ efficiency_class
	age_group
	color
	gender
	material
	pattern
	size
	size_type
	size_system
	item_group_id
	product_detail
	product_highlight
Shopping campaigns and other configurations	ads_redirect
	custom_label_0
	promotion_id
Destinations	excluded_destination
	included_destination
	shopping_ads_ excluded_country
Shipping	shipping
	shipping_label
	shipping_weight
	shipping_length
	shipping_width
	shipping_height
	ships_from_country attribute
	transit_time_label
	min_handling_time
	max_handling_time
Tax	tax
	tax_category

Click the name of an attribute to view full details, including more information about the minimum requirements, best practices, and examples.

Basic product data

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

Attribute	Format	Minimum requirements at a glance
id	Required Your product’s unique identifier Example  A2B4 Syntax Max 50 characters Schema.org property Product.sku	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. Avoid invalid characters like control, function, or private area characters Use the same ID for the same product - across countries or languages
title	Required Your product’s name Example  Mens Pique Polo Shirt Syntax Max 150 characters Schema.org property Product.name	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 a distinguishing feature such as color or size For mobile devices Include “with contract” if sold with a contract For the United States, include “with payment plan” if sold in installments For Russia For books and other information products, include the age rating at the beginning of the title
description	Required Your product’s description 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 5000 characters Schema.org property Product.description	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 Include only information about the product. Don’t include links to your store, sales information, details about competitors, other products, or accessories Use formatting (for example, line breaks, lists, or italics) to format your description
link	Required Your product’s landing page Example  http://​www.example.​com/​asp​/sp.asp?cat=​12&id=1030 Schema.org property Offer.​url	Use your verified domain name Start with http or https Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C" Don't link to an interstitial page unless legally required
image_​​link	Required The URL of your product’s main image Example  http://​www.example.​com/​image1.​jpg Schema.org property Product.image	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. For example, a comma would be represented as "%2C" Make sure the URL can be crawled by Google (robots.txt configuration allowing Googlebot and Googlebot-image)  For the image: Accurately display the product you're selling Use an accepted format: non-animated GIF (.gif), JPEG (.jpg/.jpeg), PNG (.png), BMP (.bmp), and TIFF (.tif/.tiff)  For non-apparel products, use an image of at least 100 x 100 pixels For apparel products, use an image of at least 250 x 250 pixels Don't submit an image larger than 64 megapixels or a file larger than 16MB 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 Exceptions: In Hardware (632) or Vehicles & Parts (888) categories, illustrations are accepted In any paint category, single color images are allowed
additional_​​​image_​​​link	Optional The URL of an additional image for your product Example  http://​www.example.​com/​image1.​jpg Syntax Max 2000 characters	Meet the requirements for the 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
mobile_​​link	Optional Your product’s mobile-optimized landing page when you have a different URL for mobile and desktop traffic Example  http://www.m.​example.​com/asp​/sp.asp?​cat=12&id=1030 Syntax Max 2000 alphanumeric characters	Meet the requirements for the link attribute

Price & availability

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

Attribute	Format	Minimum requirements at a glance
availability	Required Your product's availability Example in stock Supported values in stock out of stock preorder Schema.org property Offer.​availability	Accurately submit the product's availability and match the availability from your landing page
availability_​​date	Optional The date a pre-ordered product becomes available for delivery Example (For UTC+1) 2016-02-24T11:07:31​+0100 Syntax Max 25 alphanumeric characters ISO 8601 YYYY-MM-DD YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm:ssZ Schema.org property Offer.​availabilityStarts Offer.​availabilityEnds	Use this attribute if you submit availability as preorder
cost_of_goods_sold	Optional The costs associated with the sale of a particular product as defined by the accounting convention you set up. These costs may include material, labor, 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 USD Syntax ISO 4217 codes Use '.' rather than ',' to indicate a decimal point Numeric
expiration_​​date	Optional The date that your product should stop showing Example (For UTC+1) 2016-07-11T11:07:31​+0100 Syntax Max 25 alphanumeric characters ISO 8601 YYYY-MM-DD YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm:ssZ	Use a date less than 30 days in the future
price	Required Your product’s price Example 15.00 USD Syntax Numeric ISO 4217 Schema.org property Offer.​​priceSpecification	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 country of sale prominently and in a place that's straightforward to find Ensure that the product can be purchased online for the submitted price Make sure that any user in the country of sale can buy the product for the submitted price, and without paying for a membership Add any minimum order value in your shipping settings 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 See unit_​​pricing_​​measure and installment attributes for additional options to submit price-related information
sale_​​price	Optional Your product's sale price Example 15.00 USD Syntax Numeric ISO 4217	Meet the requirements for the price attribute Submit the sale_​price in addition to the price attribute with 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	Optional The date range during which the product’s sale_​price applies Example (For UTC+1) 2016-02-24T11:07:31​+0100 / 2016-02-29T23:07:31​+0100 Syntax Max 51 alphanumeric characters ISO 8601 YYYY-MM-DD YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm:ssZ Separate start date and end date with /	Use together with sale_​price If you don't submit sale_​price_​effective_​date, the sale_​price always applies Use a start date before the end date
unit_​​pricing_​​measure	Optional (except when required by local laws or regulations) The measure and dimension of your product as it is sold Example 1.5kg 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	Use the measure or dimension of the product without packaging Use a positive number For variants Include with the same value for item_group_id and different values for unit_pricing_measure
unit_​​pricing_​​base_​​measure	Optional (except when required by local laws or regulations) The product’s base measure for pricing (e.g. 100ml means the price is calculated based on a 100ml units) Example 100g 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 75cl, 750ml, 50kg, 1000kg	Optional when you submit unit_​​pricing_​​measure Use the same unit of measure for both unit_​​pricing_​​measure and unit_​pricing_​base_​measure Keep in mind that the price (or sale price, if active) is used to calculate the unit price of the product. For example, if price is 3 USD, unit_​​pricing_​​measure is 150ml, and unit_​pricing_​base_​measure is 100ml, the unit price is 2 USD / 100ml
installment	Optional (Available in Latin America for all product categories and in certain other countries for showing wireless products and services only) Details of an installment payment plan Example 6, 50 BRL Syntax installment uses 2 sub-attributes: months (required) Integer, the number of installments the buyer has to pay. amount (required) ISO 4217, the amount the buyer has to pay per month	Match the installment option that’s visible on your landing page Don't require a loyalty card For Latin America, make sure the price attribute is the total price when paid in full up-front and use the installment attribute to indicate an alternative payment option using installments. For other countries, use the price attribute (as low as 0) as the up-front payment (including any device down payment and activation fees), and the installment attribute for additional monthly installment payments.
subscription_​​cost	Optional (Available in certain countries for showing wireless products and services only) Details a monthly or annual payment plan that bundles a communications service contract with a wireless product Example month:12:35.00 USD Syntax The subscription_cost attribute uses 3 sub-attributes: period (required) The duration of a single subscription period. Either “month” or “year”. period_length (required) Integer, the number of subscription periods (months or years) that the buyer must pay. amount (required) ISO 4217, the amount the buyer must pay per month. When displaying this amount, we 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.	Submit the price attribute with the total amount due at checkout (including down payment 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	Optional (Available for Japan only) The number and type of loyalty points a customer receives when buying a product Example Program A, 100, 1.5 Syntax loyalty_​points uses 3 sub-attributes: points_​value (required) Number of points earned for the product name (optional) Name of the loyalty points program, 12 full-width characters or 24 roman characters ratio (optional) Number, the ratio of a point when converted to currency	Only submit loyalty points with a specific monetary value

Product category

You can use these attributes to organize your advertising campaigns in Google Ads and to override Google’s automatic product categorization in specific cases.

Attribute	Format	Minimum requirements at a glance
google_​​product_​​category	Optional  Google-defined product category for your product Example   Apparel & Accessories > Clothing > Outerwear > Coats & 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	Include only 1 category Include the most relevant category Include either the full path of the category or the numerical category ID Include a specific category for certain products: Alcoholic beverages must be submitted with one of these categories: Food, Beverages & Tobacco > Beverages > Alcoholic Beverages (499676), or any of its subcategories Arts & Entertainment > Hobbies & Creative Arts > Homebrewing & Winemaking Supplies (3577), or any of its subcategories Mobile devices sold with contract must be submitted as Electronics > Communications > Telephony > Mobile Phones (267) for phones or Electronics > Computers > Tablet Computers (4745) for tablets Gift Cards must be submitted as Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates (53)
product_type	Optional Product category that you define for your product Example Home > Women > Dresses > Maxi Dresses Syntax Max 750 alphanumeric character	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 organize bidding and reporting in Google Ads Shopping campaigns

Product identifiers

These attributes are used to provide product identifiers that define the products you're selling in the global marketplace. We use product identifiers to understand what you're selling. When we understand what you're selling, we can help boost the performance of your ads and free listings by adding valuable details about the product and serving it in a more relevant way to users. Learn more about product identifiers.

Attribute	Format	Minimum requirements at a glance
brand	Required (For all new products, except movies, books, and musical recording brands) Optional for all other products  Your product’s brand name Example Google Syntax Max 70 characters Schema.org property Product.brand	Provide the brand name of the product generally recognized by consumers Only provide your store name as the brand in case you manufacture the product, or your product falls into a generic brand category. For example, you could submit your store name as the brand if you sell white label products or customized jewelry If the product doesn’t have a brand, submit the manufacturer or supplier name under the brand attribute. 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	Required (For all new products with a GTIN assigned by the manufacturer) Optional (strongly recommended) for all other products  Your product’s Global Trade Item Number (GTIN) 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 are deprecated and should be converted to ISBN-13 ITF-14 (for multipacks / GTIN-14) 14-digit number like 10856435001702 Schema.org property Product.isbn Product.gtin8 Product.gtin12 Product.gtin13 Product.gtin14	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) 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 identifiers that relates to the multipack For bundles: Use the product identifiers for the main product in the bundle If you offer customization, engraving, or other personalization of a product that's been assigned a GTIN by the manufacturer: Submit the GTIN and use the is_​bundle attribute to let us know that the product includes customization
MPN	Required (Only if your new product does not have a manufacturer assigned GTIN) Optional for all other products  Your product’s Manufacturer Part Number (mpn) Example GO12345OOGLE Syntax Max 70 alphanumeric characters Schema.org property Product.mpn	Only submit MPNs assigned by a manufacturer Use the most specific MPN possible. For example, different colors of a product should have different MPNs.
identifier_​​exists	Optional  Use to indicate whether or not the unique product identifiers (UPIs) GTIN, MPN, and brand are available for your product. Example no Supported values   yes Product identifiers are assigned to the new product by the manufacturer no Product lacks a brand, GTIN, or MPN (see requirements to the right). If set to no, still provide the UPIs you have.	If you don't submit the attribute, the default is yes Your product’s category type determines which UPIs (GTIN, MPN, brand) are required. If your product is a media item and the GTIN is unavailable: Submit identifier_​exists attribute with a value of no Note: ISBN and SBN codes are accepted as GTINs.  If your product is an apparel (clothing) item and the brand is unavailable: Submit identifier_​exists attribute with a value of no In all other categories, if your product doesn’t have a GTIN, or a combination of MPN and brand:  Submit identifier_​exists attribute with a value of no

Detailed product description

These attributes are used to submit particular product characteristics that users commonly search for. The attributes can help you control how your products show when you show products that have variants. These attributes are also used to help potential customers filter by attributes when searching for products on Google. Learn more about how to submit variants.

Attribute	Format	Minimum requirements at a glance
condition	Required if your product is used or refurbished Optional for new products The condition of your product at time of sale Example new Supported values new Brand new, original, unopened packaging refurbished Professionally restored to working order, comes with a warranty, may or may not have the original packaging used Previously used, original packaging opened or missing Schema.org property Offer.​itemCondition
adult	Required (If a product contains adult content) Indicate a product includes sexually suggestive content Example yes Supported values yes no	Submit yes if this individual product contains nudity or sexually suggestive content. If you don't submit the attribute, the default 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, navigate to your Merchant Center account, click on the tool icon to open the "Tools and settings" menu, then select Shopping ads setup. Expand the “Adult content” panel, and check the box beside “My website primarily contains adult-oriented content (for example, erotic lingerie) as defined by Google's Policy.” If you check the box, you don't need to submit the adult attribute for individual products.
multipack	Required (For multipack products in Australia, Brazil, Czechia, France, Germany, Italy, Japan, Netherlands, Spain, Switzerland, the UK and the US) Required for enhanced free listings on Google if you’ve created a multipack Optional for all other products and countries of sale The number of identical products sold within a merchant-defined multipack Example 6 Syntax Integer	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 is 0 If the product's manufacturer assembled the multipack instead of you, don't submit this attribute
is_​​bundle	Required (For bundles in Australia, Brazil, Czechia, France, Germany, Italy, Japan, Netherlands, Spain, Switzerland, the UK and the US) Required for enhanced free listings on Google if you’ve created a bundle containing a main product Optional for all other products and countries of sale Indicates a product is a merchant-defined custom group of different products featuring one main product Example yes Supported values yes 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 is no Don't use this attribute for bundles without a clear main product. For example, a gift basket containing cheese and crackers
energy_​​efficiency_​​class	Optional (except when required by local law or regulations) Your product’s energy label Example A+ Supported values A+++ A++ A+ A B C D E F G	Include the legally required energy label To be used in combination with min_energy_​​efficiency_​​class and max_energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to G).
min_energy_​​efficiency_​​class	Optional (except when required by local laws or regulations) Available for EU & CH only Your product’s energy label Example A+++ Supported values A+++ A++ A B C D E F G	Include the legally required energy label To be used in combination with energy_​​efficiency_class and max_energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D).
max_energy_​​efficiency_​​class	Optional (except when required by local laws or regulations) Available for EU & CH only Your product’s energy label Example D Supported values A+++ A++ A B C D E F G	Include the legally required energy label To be used in combination with energy_​​efficiency_​​class and min_energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D).
age_​​group	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 enhanced free listings for all Apparel & Accessories (166) products Optional for all other products and countries of sale The demographic for which your product is intended Example infant Supported values newborn Up to 3 months old infant Between 3-12 months old toddler Between 1-5 years old kids Between 5-13 years old adult Typically teens or older Schema.org property Product.​audience.​suggestedMinAge Product.​audience.​suggestedMaxAge	Include one value per product For variants Include with the same value for item_​group_​id and different values for age_​group
color	Required (For all apparel products in feeds that are targeted to Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different colors) Required for enhanced free listings for all Apparel & Accessories (166) products Optional for all other products and countries of sale Your product’s color(s) Example Black Syntax Max 100 alphanumeric characters (max 40 characters per color) Schema.org property Product.color	Don’t use a number such as 0 2 4 6 8 Don’t use characters that aren’t alphanumeric such as #fff000 Don’t use only 1 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 1 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 with the same value for item_​group_​id and different values for color
gender	Required (Required for all apparel items in feeds that are targeted to people in Brazil, France, Germany, Japan, the UK, and the US as well as all gender-specific products) Required for enhanced free listings for all Google Apparel & Accessories (166) products Optional for all other products and countries of sale The gender for which your product is intended Example Unisex Supported values male female unisex Schema.org property Product.​audience.​suggested​Gender	For some Apparel & Accessories (166) categories like Shoelaces (1856), this attribute is recommended instead of required since these categories aren't dependent on gender For variants Include with the same value for item_​group_​id and different values for gender
material	Required (if relevant for distinguishing different products in a set of variants) Optional for all other products Your product’s fabric or material Example leather Syntax Max 200 characters Schema.org property Product.material	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 with the same value for item_​group_​id and different values for material
pattern	Required (if relevant for distinguishing different products in a set of variants) Optional for all other products Your product’s pattern or graphic print Example striped polka dot paisley Syntax Max 100 characters Schema.org property Product.pattern	For variants Include with the same value for item_​group_​id and different values for pattern
size	Required (Required for all apparel products in Apparel & Accessories > Clothing (1604) and Apparel & Accessories > Shoes (187) product 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 enhanced free listings for all Apparel & Accessories > Clothing (1604) and Apparel & Accessories > Shoes (187) products. Optional for all other products and countries of sale Your product’s size Example XL Syntax Max 100 characters Schema.org property Product.size	For variants: Include with the same value for item_​group_​id and different values for size If sizes contain multiple dimensions, condense them into 1 value. For example, "16/34 Tall" for neck size 16 inches, sleeve length 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 attribute. Do not submit the multipack quantity under size.
size_​​type	Optional (Available for apparel products only) Your apparel product’s cut Example maternity Supported values regular petite oversize maternity	If you don't submit the attribute, the default is regular
size_​​system	Optional (Available for apparel products only) The country of the size system used by your product Example US Supported values US UK EU DE FR JP CN (China) IT BR MEX AU	If you don't submit the attribute, the default is your country of sale
item_group_id	Required (Brazil, France, Germany, Japan, the United Kingdom, and the US if the product is a variant) Required for enhanced free listings for all product variants Optional for all other products and countries of sale ID for a group of products that come in different versions (variants) Example AB12345 Syntax Max 50 alphanumeric characters Schema.org property Product.​inProductGroupWithID	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: color size pattern material age group gender Include the same attributes for each product in the item group. For example, if a product varies by size and color, submit size and color for every product that share the same value for 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_detail	Optional Technical specifications or additional details of your product Example General:Product Type:Digital player Syntax product_detail uses 3 sub-attributes: section_name: Max 140 characters attribute_name: Max 140 characters attribute_value: Max 1000 characters	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, and not just because False is the default value for Boolean attributes.
product_highlight	Optional The most relevant highlights of your products Example Supports thousands of apps, including Netflix, YouTube, and HBO Now Syntax Max 150 characters	Use between 2 and 10 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	Format	Minimum requirements at a glance
ads_​​redirect	Optional  A URL used to specify additional parameters for your product page. Users will be sent to this URL rather than the value that you submit for link or mobile_link Example   http://www.​example.com/​product.​html Syntax Max 2000 characters	Submit the same registered domain as for the link attribute (and the 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 through custom_label_4	Optional  Label that you assign to a product to help organize bidding and reporting in Shopping campaigns Example seasonal  clearance holiday sale price range Syntax Max 100 characters	Use a value that you'll recognize in your Shopping campaign. The value won't be shown to users who see your ads and free listings. Submit up to 5 custom labels per product by including this attribute multiple times: custom_​label_​0 custom_​label_​1 custom_​label_​2 custom_​label_​3 custom_​label_​4 Use only 1,000 unique values for each custom label across your Merchant Center account
promotion_​​id	Optional (Required for promotions in Australia, France, Germany, India, the UK and the US) An identifier that allows you to match products to promotions Example ABC123 Syntax Max 50 characters	Use a unique and case sensitive ID without spaces or symbols (e.g., %, !)  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

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.

Attribute	Format	Minimum requirements at a glance
excluded_​​destination	Optional A setting that you can use to exclude a product from participating in a specific type of advertising campaign Example Shopping ads Supported values Shopping ads Buy on Google listings Display ads Local inventory ads Free listings Free local listings
included_​​destination	Optional A setting that you can use to include a product in a specific type of advertising campaign Example Shopping ads Supported values Shopping ads Buy on Google listings Display ads Local inventory ads Free listings Free local listings
shopping_ads_excluded_country	Optional A setting that allows you to exclude countries where your products are advertised on Shopping ads. Only available for Shopping ads Example DE Syntax 2 characters. Must be an ISO_3166-1_alpha-2 country code.

Shipping

These attributes can be used together with the account shipping settings to help you provide accurate shipping costs. Users rely on the shipping costs to help make choices about what to buy, so it's important to take the time to submit quality shipping information. Learn how to set up account shipping settings.

ships_from_country

Attribute	Format	Minimum requirements at a glance
shipping	Optional (Required when shipping costs for your product are not defined in your Merchant Center account or when you need to override shipping costs defined in your Merchant Center account) Shipping costs are required for Shopping ads for products with the following countries of sale: Australia, Austria, Belgium, Canada, Czechia, France, Germany, Ireland, Israel, Italy, the Netherlands, Poland, South Korea, Spain, Switzerland, the UK, and the US Shipping costs are required for free enhanced listings for all products Optional (to specify additional countries your product ships to or destinations where shipping costs are not required) Not available for Buy on Google listings Your product's shipping cost and the locations your product ships to. Supported prices 0–1000 USD (check here for other currencies) Example US:CA:Overnight:16.00 USD Syntax shipping uses 4 sub-attributes: country (required) ISO 3166 country code region or postal_​code or location_​id or location_group_name (optional) service (optional) Service class or shipping speed price (optional) Fixed shipping cost, including VAT if required	Use this setting to override the Merchant Center account shipping settings for an individual product or to specify additional countries your product ships to.
shipping_​​label	Optional Label that you assign to a product to help assign correct shipping costs in Merchant Center account settings Example perishable Syntax Max 100 characters	Use a value that you'll recognize in your account shipping settings. The value won't be shown to users. Examples: Sameday Oversize Only FedEx
shipping_​​weight	Optional (Required for carrier-calculated rates, a table based on weight, or a rule based on weight in your account shipping settings) The weight of the product used to calculate the shipping cost Supported weights 0–2000 lbs for imperial 0–1000 kgs for metric Example 3 kg Syntax Number + unit Supported units lb oz g kg	Submit this value if you set up account shipping settings for carrier-calculated rates or weight-based shipping services
shipping_​​length	Optional (Required for carrier-calculated rates in your account shipping settings) The length of the product used to calculate the shipping cost by dimensional weight Example 20 in Syntax Number + unit Supported values 1 - 150 for inches 1 - 400 for cm Supported units in cm	Submit this value if you set up account shipping settings for carrier-calculated rates If you don't provide shipping dimension attributes while using carrier-calculated rates, we won't be able to calculate rates based on the dimensional weight of the item. If that's the case, we'll just calculate the rates based on the value you provided in shipping_​weight If you submit this attribute, submit all shipping dimension attributes: shipping_​length shipping_​width shipping_​height Use the same unit for all shipping dimension attributes that apply to a single product Keep in mind that Google doesn't automatically calculate additional shipping cost for oversized items. If your package would be considered large or oversized by your carrier, you should either use the shipping attribute to set shipping cost for an individual product or use the shipping_​label attribute with account shipping settings to set the cost
shipping_​​width	Optional (Required for carrier-calculated rates in your account shipping settings) The width of the product used to calculate the shipping cost by dimensional weight Example 20 in Syntax Number + unit Supported values 1 - 150 for inches 1 - 400 for cm Supported units in cm	Meet the requirements for the shipping_​length attribute
shipping_​​height	Optional (Required for carrier-calculated rates in your account shipping settings) The height of the product used to calculate the shipping cost by dimensional weight Example 20 in Syntax Number + unit Supported values 1 - 150 for inches 1 - 400 for cm Supported units in cm	Meet the requirements for the shipping_​length attribute
ships_from_country	Optional A setting that allows you to provide the country from which your product will typically ship. Example DE Syntax 2 characters. Must be an ISO_3166-1_alpha-2 country code.	Provide only the country from which you typically ship this product
transit_time_label	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	Use a value that you'll recognize in your account shipping settings. The value won't be shown to users. Examples: Dog food From Seattle Heavy package
max_handling_time	Optional The longest amount of time between when an order is placed for a product and when the product ships. Example 3 Syntax Integer, greater than or equal to 0	Submit this attribute if you want to display the overall time it takes for a product to arrive at its destination Submit the number of business days (as configured in Merchant Center) For products ready to be shipped the same day, submit 0. For submitting a time range submit max_handling_time in combination with min_handling_time.
min_handling_time	Optional The shortest amount of time between when an order is placed for a product and when the product ships. Example 1 Syntax Integer, greater than or equal to 0	Meet the requirements for the max_handling_time attribute

Tax

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

Attribute	Format	Minimum requirements at a glance
tax	Required (Available for the US only) Your product’s sales tax rate in percent Example  US:CA:5.00:y Syntax tax uses 4 sub-attributes: rate (required)  Tax rate as a percentage country (optional) ISO 3166 country code  region or postal_​code or location_​id (optional) tax_​ship (optional) Specify if you charge tax on shipping. Accepted values are yes or 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 attribute. For the US only, include the tax in the 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	Optional (Recommended for custom tax rates at the account level) A category that classifies your product by specific tax rules Example  apparel Syntax Max 100 characters	Use this attribute if you have products that have a specific tax rate.  Category labels in your product data must match the labels you enter in the Categories section in Merchant Center.