Google Shopping Feed Specs Guide

Use this Google feed spec breakdown to format your product information for Shopping ads. Submitting your product data to Google in the right format is important for creating successful ads for your products.

Updated: 10/3/2018

Basic product data

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

id

Required

ExampleSyntaxSchemaA2B4Max 50 charactersProduct.sku

This attribute feeds Google your product’s unique identifier.

• 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

ExampleSyntaxSchemaMens Pique Polo ShirtMax 150 charactersProduct.name

This attribute feeds Google your product’s 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

ExampleSyntaxSchema 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.Max 5000 charactersProduct.description

This attribute feeds Google your product’s description.

• Type format: String (Unicode characters, some plain HTML, ASCII)
• Supported (non-exhaustive): strong, em, ul, ol, li, br, sub, sup, div, span, dl, dt, dd
• Not supported: Attributes of all tags, Unsafe tags (i.e. "style," "canvas")
• 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

image_link

Required

ExampleSyntaxSchemahttp://www.example.com/image1.jpgMax 2000 charactersProduct.image

This attribute feeds Google the URL of your product’s main 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

ExampleSyntaxSchemahttp://www.example.com/image2.jpgMax 2000 charactersn/a

This attribute feeds Google the URL of an additional image for your product.

• 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

ExampleSyntaxSchemaA2B4Max 50 charactersProduct.sku

This attribute feeds Google your product’s mobile-optimized landing page when you have a different URL for mobile and desktop traffic.

• Meet the requirements for the link attribute

Price and availability

These attributes define the price and availability for your products. This information is shown to potential customers in your ads. 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 run ads.

availability

Required

ExampleSupported valuesSchemaA2B4in stock
out of stock
preorderOffer.availability

This attribute feeds Google your product’s unique identifier.

• Accurately submit the product's availability and match the availability from your landing page

availability_date

Optional

ExampleSyntaxSchema(For UTC+1)
2016-02-24T11:07:31+0100Max 25 alphanumeric characters
ISO 8601
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DDThh:mm:ssZOffer.availabilityStarts
Offer.availabilityEnds

This attribute feeds Google the date a pre-ordered product becomes available for delivery.

• Use this attribute if you submit availability as preorder

cost_of_goods_sold

Optional

ExampleSyntaxSchema23.00 USDISO 4217 codes
Use '.' rather than ',' to indicate a decimal point
Numericn/a

This attribute feeds Google the costs associated with the sale of a particular item 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 Shopping ads.

expiration_date

Optional

ExampleSyntaxSchema(For UTC+1)
2016-07-11T11:07:31+0100Max 25 alphanumeric characters
ISO 8601
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DDThh:mm:ssZn/a

This attribute feeds Google the date that your product should stop showing.

• Use a date less than 30 days in the future

price

Required

ExampleSyntaxSchema15.00 USDNumeric
ISO 4217Offer.priceSpecification

This attribute feeds Google your product’s price.

• Accurately submit the product's price and currency, and match with the price from your landing page
• Make sure that your landing page includes 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

ExampleSyntaxSchema10.00 USDNumeric
ISO 4217Offer.priceSpecification

This attribute feeds Google your product's sale price.

• 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 from your landing page

sale_price_effective_date

Optional

ExampleSyntaxSchema(For UTC+1)
2016-02-24T11:07:31+0100 / 2016-02-29T23:07:31+0100Max 51 alphanumeric characters
ISO 8601
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DDThh:mm:ssZ
Separate start date and and end date with /Offer.priceSpecification.validFrom
Offer.priceSpecification.validThrough

This attribute feeds Google the date range during which the product’s sale_price applies.

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

ExampleSyntaxSchema1.5lbNumerical value + unitProduct.name

This attribute feeds Google the measure and dimension of your product as it is sold.

• Use the measure or dimension of the product without packaging
• Use a positive number

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

unit_pricing_base_measure

Optional (except when required by local laws or regulations)

ExampleSyntaxSchema100gInteger + unitOffer.price
Specification.reference
Quantity.valueReference

This attribute feeds Google the product’s base measure for pricing (e.g. 100ml means the price is calculated based on a 100ml units).

• 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

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

installment

Optional (available for Brazil and Mexico only)

ExampleSyntaxSchema6, 50 BRLinstallment uses 2 sub-attributes:

months (required)
Integer, the number of installments the buyer has to pay.
amount (optional)
ISO 4217, the amount the buyer has to pay per monthProduct.name

This attribute feeds Google the details of an installment payment plan.

• Match the installment option that’s visible on your landing page
• Don't require a loyalty card
• Make sure you still include the price attribute with the total price for the product

loyalty_points

Optional (available only for Japan)

ExampleSyntaxSchemaProgram A, 100, 1.5loyalty_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 currencyn/a

This attribute feeds Google the number and type of loyalty points a customer receives when buying a product.

• Only submit loyalty points with a specific monetary value

Product category

These attributes help Google understand what you're selling so we can better connect your ads with search queries from potential customers. Keep in mind that you can also use these product categorizations later on to help you organize your advertising campaign in Google Ads.

google_product_category

Required (for Apparel & Accessories [166], Media [783] and Software [2092] categories)

ExampleSyntaxSchemaApparel & Accessories > Clothing > Outerwear > Coats & Jackets
or
371Value from the Google product taxonomy

The numerical category ID, or
The full path of the categoryProduct.name

This attribute feeds Google its own defined product category for your product.

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

For supported values, see the Google product taxonomy list.

product_type

Optional

ExampleSyntaxSchemaHome > Women > Dresses > Maxi DressesMax 750 alphanumeric charactern/a

This attribute feeds Google the product category that you define for your product.

• 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 your ad performance by adding valuable details about the product and serving the ad in a more relevant way to users.

brand

Required (for all new products, except movies, books, and musical recording brands)

ExampleSyntaxSchemaGoogleMax 70 charactersProduct.brand

This attribute feeds Google your product’s brand name.

• 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 you don't have a brand to provide, don't provide a value. For example, don't use 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)

ExampleSyntaxSchema3234567890126Max 50 numeric characters (max 14 per value - added spaces and dashes are ignored)Product.isbn
Product.gtin8
Product.gtin12
Product.gtin13
Product.gtin14

This attribute feeds Google your product’s Global Trade Item Number (GTIN).

• 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
• If your product doesn't have both a GTIN and MPN:
• Set identifier_exists to no (FALSE)

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

MPN

Required (only if your new product does not have a manufacturer assigned GTIN)

ExampleSyntaxSchemaGO12345OOGLEMax 70 alphanumeric charactersProduct.mpn

This attribute feeds Google your product’s Manufacturer Part Number (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
• If your product doesn't have both a GTIN and MPN:
• Set identifier_exists to no (FALSE)

identifier_exists

Optional

ExampleSyntaxSchemayesn/an/a

This attribute is to be used if your new product doesn’t have a GTIN and brand or MPN and brand.

• If you don't submit the attribute, the default is yes
• If your product doesn't have a GTIN and brand, or MPN and brand:
• Set identifier_exists to no

Supported values  

• yes
  Product identifiers are assigned to the new product by the manufacturer
• no
  No GTIN, brand, or MPN are assigned to the new product by the manufacturer

Detailed product description (variants)

These attributes are used to submit particular product characteristics that users commonly search for. The attributes can help you control your ad's appearance when you advertise variants. These attributes are also used to help potential customers filter by attributes on Google Shopping.

condition

Required (if your product is used or refurbished)

ExampleSyntaxSchemarefurbishedn/aOffer.itemCondition

This attribute feeds Google the condition of your product at time of sale.

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

adult

Required (if your product contains adult content)

ExampleSyntaxSchemayesn/an/a

This attribute indicates to Google that a product includes sexually suggestive content

• 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 to your Merchant Center account, open General Settings, and check the box next to “This site contains adult products as defined by our policy.” If you check the box, you don't need to submit the adult attribute for individual products.

Supported values

• yes
• no

multipack

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

ExampleSyntaxSchema6Integer, greater than 1 (multipacks cannot contain 1 product)n/a

This attribute feeds Google the number of identical products sold within a merchant-defined multipack.

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

ExampleSyntaxSchemayesn/an/a

This attribute indicates to Google that a product is a merchant-defined custom group of different products featuring one main product.

• 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

Supported values

• yes
• no

energy_efficiency_class

Optional (Available for EU & CH only, may be required by local laws or regulations)

ExampleSyntaxSchemaA+n/an/a

This attribute feeds Google your product’s energy label.

• 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 D).

Supported values

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

min_energy_efficiency_class

Optional (Available for EU & CH only, may be required by local laws or regulations)

ExampleSyntaxSchemaA+++n/an/a

This attribute feeds Google your product’s energy label.

• 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).

Supported values

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

max_energy_efficiency_class

Optional (Available for EU & CH only, may be required by local laws or regulations)

ExampleSyntaxSchemaDn/an/a

This attribute feeds Google your product’s energy label.

• 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).

Supported values

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

age_group

Required (for all apparel items that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products with assigned age groups)

ExampleSyntaxSchemainfantn/aProduct.audience.suggestedMinAge
Product.audience.suggestedMaxAge

This attribute feeds to Google the demographic for which your product is intended.

• Include one value per product
• For variants
• Include with the same value for item_group_id and different values for age_group

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

color

Required (for all apparel items in feeds that target Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different colors)

ExampleSyntaxSchemaBlackMax 100 alphanumeric characters (max 40 characters per color)Product.color

This attribute feeds to Google your product’s color(s).

• 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 (for all apparel items in feeds that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all gender-specific products)

ExampleSyntaxSchemaUnisexn/aProduct.audience.suggestedGender

This attribute feeds to Google the gender for which your product is intended.

• 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

Supported values

• male
• female
• unisex

material

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

ExampleSyntaxSchemaleatherMax 200 characters

n/a

This attribute feeds to Google your product’s fabric or 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)

ExampleSyntaxSchemastriped
polka dot
paisleyMax 100 charactersn/a

This attribute feeds to Google your product’s pattern or graphic print.

• For variants
• Include with the same value for item_group_id and different values for pattern

size

Required (for all apparel items in the Apparel & Accessories > Clothing and Apparel & Accessories > Shoes product categories focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different sizes)

ExampleSyntaxSchemaXLMax 100 charactersn/a

This attribute feeds to Google your product’s 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

size_type

Optional (for apparel products only)

ExampleSyntaxSchemamaternityn/an/a

This attribute feeds to Google your apparel product’s cut.

• If you don't submit the attribute, the default is regular

Supported values

• regular
• petite
• plus
• big and tall
• maternity

size_system

Optional

ExampleSyntaxSchemaUSn/an/a

Available for apparel products only.

This attribute feeds to Google the country of the size system used by your product.

• If you don't submit the attribute, the default is your county of sale

Supported values

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

item_group_id

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

ExampleSyntaxSchemaAB12345Max 50 alphanumeric charactersn/a

This attribute feeds to Google the ID for a group of products that come in different versions (variants).

• 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

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.

ads_redirect

Optional

ExampleSyntaxSchemahttp://www.example.com/product.htmlMax 2000 charactersn/a

This attribute feeds to Google 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.

• Submit the same registered domain as the value for ads_redirect, link, and mobile_link.
• 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

Optional

ExampleSyntaxSchemaseasonal
clearance
holiday
sale
price rangeMax 100 charactersn/a

This attribute feeds to Google the label that you assign to a product to help organize bidding and reporting in Shopping campaigns.

• Use a value that you'll recognize in your Shopping campaign. The value won't be shown to users who see your ads
• 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 (but required for Merchant Promotions in Australia, France, Germany, India, the UK and the US)

ExampleSyntaxSchemaABC123Max 50 charactersn/a

This attribute feeds to Google an identifier that allows to you match products to Merchant promotions.

• 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 type of ads your products participate in. For example, you could use this attribute if you want a product to appear in a dynamic remarketing campaign, but not in a Shopping campaign.

excluded_destination

Optional

ExampleSyntaxSchemaDisplay Adsn/an/a

This attribute feeds to Google a setting that you can use to exclude a product from participating in a specific type of advertising campaign.

Supported values

• Shopping
• Shopping Actions
• Display Ads

included_destination

Optional

ExampleSyntaxSchemaShopping Actionsn/an/a

This attribute feeds to Google a setting that you can use to include a product in a specific type of advertising campaign.

Supported values

• Shopping
• Shopping Actions
• Display Ads

Shipping

These attributes can be used together with the account shipping settings to help you provide accurate shipping costs in your ads. 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.

shipping

Required (for Australia, Czechia, France, Germany, Israel, Italy, Netherlands, South Korea, Spain, Switzerland, the UK, and the US)

ExampleSyntaxSchemaUS:CA:Overnight:16.00 USDshipping uses 4 sub-attributes:

country (optional)
ISO 3166 country code
region or postal_code or location_id or location_group_name (optional)
service (optional)
Service class or shipping speed
price (required)
Fixed shipping cost, including VAT if requiredn/a

This attribute feeds to Google your product's shipping cost. Supported prices
0–1000 USD (check here for other currencies).

• Use this setting only to override the Merchant Center account shipping settings for an individual item

shipping_label

Optional

ExampleSyntaxSchemaperishableMax 100 charactersn/a

This attribute feeds to Google the label that you assign to a product to help assign correct shipping costs in Merchant Center account settings.

• Use a value that you'll recognize in your account shipping settings. The value won't be shown to users who see your ads. Examples:
• Sameday
• Oversize
• Only FedEx

shipping_weight

Optional (but required for carrier-calculated rates, a table based on weight, or a rule based on weight in your account shipping settings)

ExampleSyntaxSchema3 kgInteger + unitn/a

This attribute feeds to Google the weight of the product used to calculate the shipping cost.

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

Supported weights

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

Supported units

• lb
• oz
• g
• kg

shipping_length

Optional (but required for carrier-calculated rates in your account shipping settings)

ExampleSyntaxSchema12 inInteger + unitn/a

This attribute feeds to Google the length of the product used to calculate the shipping cost by dimensional weight.

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

Supported integers

• 1 - 150 for inches
• 1 - 400 for cm

Supported units

• in
• cm

shipping_width

Optional (but required for carrier-calculated rates in your account shipping settings)

ExampleSyntaxSchema10 inInteger + unitn/a

This attribute feeds to Google the width of the product used to calculate the shipping cost by dimensional weight.

• Meet the requirements for the shipping_length attribute

Supported integers
A value between 1 and 1000

Supported units

• in
• cm

shipping_height

Optional (but required for carrier-calculated rates in your account shipping settings)

ExampleSyntaxSchema20 inInteger + unitn/a

This attribute feeds to Google the height of the product used to calculate the shipping cost by dimensional weight.

• Meet the requirements for the shipping_length attribute

Supported integers
A value between 1 and 1000

Supported units

• in
• cm

max_handling_time

Optional (US only)

ExampleSyntaxSchema3Integer, greater than 1Offer.deliveryLeadTime.maxValue

This attribute feeds to Google the longest amount of time between when an order is placed for a product and when the product ships.

• Submit this attribute if you want to display the overall time it takes for a product to arrive at its destination
• Do not include weekends.
• For products ready to be shipped the same day, submit 0.
• For submitting a time range submit max_handling_time in combination with max_handling_time.

min_handling_time

Optional (US only)

ExampleSyntaxSchema1Integer, greater than 1Offer.deliveryLeadTime.minValue

This attribute feeds to Google the shortest amount of time between when an order is placed for a product and when the product ships.

• 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 in your ads.

tax

Required (US only)

ExampleSyntaxSchemaUS:CA:5.00:ytax 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 non/a

This attribute feeds to Google your product’s sales tax rate in percent.

• Use this setting only to override the account tax settings for an individual item. 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 (but recommended for custom tax rates at the account level)

ExampleSyntaxSchemaapparelMax 100 charactersn/a

This attribute feeds to Google a category that classifies your product by specific tax rules.

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.

‍