Product Feed Specification

In order to prevent suspension of your feed please read the Google Shopping policies very carefully before creating a feed.

This page lists all the attributes that you need to provide in order for your products to be listed in Google Shopping. Some attributes are required for all items, some are required for certain types of items (such as clothing) and others are recommended. Failure to provide a required attribute may prevent that particular item from showing up in Google Shopping results, whereas failure to provide recommended attributes may result in items showing up less frequently. Read through the entire document to make sure that your products show up on Google Shopping. For a basic overview of feeds, see this article. Before creating your feed, choose the file format that is right for you.

You can also review a summary of attribute requirements for a quick view of the specification for your target country.

We use the term item to describe a single product listing. If you are using Text or Tab delimited format, an item is equivalent to one line in your data feed. Items are similar to products, but we assume that products can occur in multiple variations. These variations – product variants – differ by colour, material, pattern or size. We use item to refer to a single variation of a product.

We also accept feeds formatted according to the Yandex specifications for data feeds targeting Russia.

Important Note:

  • If you are using a delimited format, you can use the attribute names either in English or the language of your target country. Make sure that the attribute names (e.g. 'condition') and values (e.g. 'new') are always in the same language.
  • If you are using XML or API, you must use English attribute names shown within the brackets.
  • If you are using XML or API, you must use an underscore in place of 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").
Expand all   Collapse all

Basic Product Information

ID [id] – An identifier of the item

The identifier for each item has to be unique within your account, and cannot be re-used between feeds for the same country in the same language. If you have multiple feeds for one country, IDs of items within different feeds must still be unique. If your SKUs are unique across your inventory and meet the requirements below, we suggest that you use your SKUs for this attribute.

When to include: Required for all items.

Type String
Character limit 50
Text/Tab delimited tddy123uk
XML (Feeds) <g:ID>tddy123uk</g:ID>

Important:

  • Starting and trailing whitespaces and carriage returns (0x0D) are removed.
  • Each sequence of carriage return (0x0D) and whitespace characters (Unicode characters with the whitespace property) is replaced by a single whitespace (0x20).
  • Only valid unicode characters are accepted; this excludes the following characters:
    • control characters (except carriage return 0x0D)
    • function characters
    • private area characters
    • surrogate pairs
    • non-assigned code points (in particular any code point larger than 0x10FFFF)
  • Once an item has been submitted, the ID must not change when you update your data feed.
  • Once an item has been submitted, the ID must not be used for a different product at a later point in time.
  • For Belgium, Canada and Switzerland only: If your website is in multiple languages, submit one feed per language. You may reuse the same ID for the same item in each version of the feed for each language.
title [title] – Title of the item

This is the name of your item, which is required. We recommend that you include characteristics such as colour or brand in the title, which differentiates the item from other products.

When to include: Required for all items.

Type Text
Character limit 150
In most cases, only 70 or fewer characters will be displayed
Text/Tab-delimited Men’s Pique Polo Shirt
XML (Feeds) <title>Mens Pique Polo Shirt</title>

Important:

  • Follow our Editorial guidelines closely. For example, do not include any promotional text such as "Free delivery", and do not use BLOCK CAPITALS.
  • For variant products, you are required to include the common title of the variant items. For example if “Men’s Pique Polo Shirt” is available in red and blue, you can have one of the following titles:
    • Men’s Pique Polo Shirt (can be used for both variants)
    • Men’s Pique Polo Shirt – Red (for the red shirt)
    • Men’s Pique Polo Shirt – Blue (for the blue shirt)
  • For mobile phones or tablets, a subsidised price with a service contract is allowed. In this case, the price can be as low as 0. The items must be submitted with the ‘google product taxonomy’ value of ‘Electronics > Communications > Telephony > Mobile Phones’ for phones and 'Electronics > Computers > Tablet Computers’ for tablets, and include the phrase “only with contract” (or equivalent language) in the ‘title’.
  • In the US, payment schemes featuring multiple instalments are allowed for mobile phones and tablets. In this case, submit the price of the down payment as your ‘price’. The ‘title’ must include the phrase “with payment plan” (or equivalent language). For feeds targeting Brazil, please use the ‘instalment’ attribute to submit mobile phones or tablets with multiple instalments. Mobile phones or tablets with these types of payment schemes are not allowed in other target countries.
  • Information products in Russia need to specify the age rating at the beginning of the item title. This includes books and other printed or digital media and any other products that may include information that is age-restricted in Russia.
    • Title: “(age rating)” + “title of your item”. Example: (18+) Братья Карамазовы
    • The age rating must be one of the following: 18+, 16+, 12+, 6+ or 0+
description [description] – Description of the item

Only include information relevant to the item. Describe its most relevant attributes, such as size, material, intended age range, special features or other technical specs. Also include details about the item’s most visual attributes, such as shape, pattern, texture and design, since we may use this text to find your item.

We recommend that you submit around 500 to 1,000 characters, but you can submit up to 5,000 characters. Descriptions should follow standard grammar rules and end with a punctuation mark.

When to include: Required for all items.

Type Text
Character limit 5,000
Text/Tab-delimited Solid red, king-sized bed sheets made from 100% woven polyester 300-thread count fabric. Set includes one fitted sheet, one flat sheet and two standard pillowcases. Machine washable; extra-deep fitted pockets.
XML <description>Solid red, king-sized bed sheets made from 100% woven polyester 300-thread count fabric. Set includes one fitted sheet, one flat sheet and two standard pillowcases. Machine washable; extra-deep fitted pockets.</description>

Important:

  • Be sure to follow our Editorial guidelines closely. For example, do not include any promotional text such as "Free delivery", do not use BLOCK CAPITALS and do not include a description of your brand or company.
  • Additionally, the following information should not be included in descriptions:
    • Links to your shop or other websites
    • Billing, payment or sales information
    • References to internal categorisation systems, e.g. "Toys & Games > Toys > Baby Dolls"
    • Comparisons to other products beyond the item that you’re selling, e.g. “even better/faster/larger than X”
    • Details about other products, accessories or similar items available
google product category [google_product_category] – Google's category of the item

The 'google product category' attribute indicates the category of the product being submitted, according to the Google product taxonomy. This attribute accepts only predefined values, taken from the product taxonomy tree. If your items fall into multiple categories, include only one category – the most relevant one.

For all items, submitting more specific categories can make bidding by category more precise.

Any category from Google’s product taxonomy must include the full path or the category ID. 5598 or ‘Clothing & Accessories > Clothing > Outerwear > Coats & Jackets’ are acceptable values, but ‘Coats & Jackets’ is not.

When to include: For all target countries except Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey, ‘google product category’ is required for all items that fall within the 'Clothing & Accessories', 'Media' and 'Software' categories. If your products do not fall into one of those categories – or if your feed targets Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden or Turkey – this attribute is recommended but not required.

Type Predefined values from Google's product taxonomy: the ID or the full path of the product category
Text/Tab delimited 2271
or
Clothing & Accessories > Clothing > Dresses
XML (Feeds) <g:google_product_category>2271</g:google_product_category>
or
<g:google_product_category>Clothing &amp; Accessories &gt; Clothing &gt; Dresses</g:google_product_category>

Additional category requirements: For items that fall into the categories listed below, the value that you submit for ‘google product category’ must use the categories as they appear below or the more specific categories provided in the full Google product taxonomy. It is not sufficient to provide the highest-level categories, such as 'Clothing & Accessories' or ‘Media’, for these items.

  • 1604 or 'Clothing & Accessories > Clothing'
  • 187 or 'Clothing & Accessories > Shoes'
  • 178 or 'Clothing & Accessories > Clothing Accessories > Sunglasses'
  • 3032 or 'Clothing & Accessories > Handbags, Wallets & Cases > Handbags'
  • 201 or 'Clothing & Accessories > Jewellery > Watches'
  • 784 or 'Media > Books'
  • 839 or 'Media > DVDs & Videos'
  • 855 or 'Media > Music'
  • 1279 or 'Software > Video Game Software' (Note: this category includes all computer games)

Category for alcoholic beverages: Google Shopping allows the promotion of the sale of alcohol with a few restrictions. Alcohol must be submitted with the ‘google product category’ value of

  • 499676 or 'Food, Beverages & Tobacco > Beverages > Alcoholic Beverages', or any of its subcategories
  • 3577 or 'Arts & Entertainment > Hobbies & Creative Arts > Crafts & Hobbies > Homebrewing & Wine Making Supplies', or any of its subcategories

Please see our policy on Alcoholic Beverages for more information on submitting alcohol-related products.

Category for bundles: Provide the most appropriate categorisation for bundled products of differing product types. If the bundle contains a main product, the category of the main product is most appropriate. For example, if you are submitting a digital SLR camera bundled with a bag, ‘Cameras & Optics > Cameras > Digital Cameras’ (152) is an appropriate category to submit for the bundled item.

Category for mobile phones or tablets with subsidised price: For mobile phones or tablets, subsidised price with a service contract is allowed. In this case, the price can be as low as 0. The items must be submitted with the ‘google product category’ value of ‘Electronics > Communications > Telephony > Mobile Phones’ (267) for phones or 'Electronics > Computers > Tablet Computers' (4745) for tablets and include the phrase “only with contract” (or equivalent language) in the 'title'.

Category for gift cards: Google Shopping allows the promotion of gift cards with a few restrictions. Gift cards must be submitted with the 'google product category' value of 'Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates' (53). Please see our policy on Financial and Other Related Products for more information on submitting gift cards.

Examples of 'google product category' submissions

Coats and jackets fall under the 'Clothing & Accessories > Clothing' category specified above. When submitting a coat or jacket:

  • Acceptable categories:
    • 1604 or 'Clothing & Accessories > Clothing'
    • 203 or 'Clothing & Accessories > Clothing' > Outerwear'
    • 5598 or 'Apparel & Accessories > Clothing > Outerwear > Coats & Jackets'
  • Invalid categories:
    • 166 or 'Clothing & Accessories'
    • Failing to provide any 'google product category'

Rings do not fall under the specific categories listed above. When submitting rings:

  • Acceptable categories:
    • 166 or 'Clothing & Accessories'
    • 188 or 'Clothing & Accessories > Jewellery
    • 200 or 'Clothing & Accessories'> Jewellery > Rings'
  • Invalid categories:
    • Failing to provide any 'google product category'

For all your items, conforming to the above guidelines is required. However, it is strongly recommended that you use the most specific applicable category for all of your items from the full Google product taxonomy.

product type [product_type] - Your item category

This attribute also indicates the category of the product being submitted, but you can provide your own classification. Unlike the 'Google product category', you can include more than one 'product type' attribute value if products apply to more than one category. Please include the full category string. For example, if your products belong in Refrigerators, list the full string: Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators. You must use " > " as a separator, including a space before and after the symbol. If you submit multiple values, only the first value will be used as the ‘product type’ for your Shopping campaigns. Learn more about using product type to organise your Shopping campaigns.

When to include: Strongly recommended for all items if you have a categorisation for your items.

Type Text. You may include multiple product types, if it's appropriate for your item. Separate by a comma for tab-delimited; include multiple <product_type> attributes for XML.
Character limit 750
Text/Tab-delimited Home & Garden > Kitchen & Dining > Appliances > Refrigerators
XML (Feeds) <g:product_type>Home &amp; Garden &gt; Kitchen &amp; Dining &gt; Appliances &gt; Refrigerators</g:product_type>
link [link] - URL directly linking to your item's page on your website

The user is sent to this URL when your item is clicked on Google Shopping. We also refer to this as the landing page. It must point to a page showing the essentially identical item that the user was looking at. You can use tracking URLs to distinguish users coming from Google Shopping.

The URL contained in this attribute is a direct link to your product page. In addition to the 'link' attribute, you may also specify an 'adwords redirect' attribute for tracking purposes. If you specify the 'adwords redirect' attribute, the user is sent to the URL specified in the 'adwords redirect' attribute. This URL must redirect to the same website as the one specified in the 'link' attribute. If you don't specify the 'adwords redirect' attribute, the user is sent directly to the URL specified in the 'link' attribute

When to include: Required for all items.

Type URL (this must include the http:// portion)
Character limit 2,000
Text/Tab delimited http://www.example.com/asp/sp.asp?cat=12&id=1030
XML (Feeds) <link>http://www.example.com/asp/sp.asp?cat=12&amp;id=1030</link>

Important:

  • Read our Landing Page Content policy carefully.
  • If you have out of stock items or don't want to receive traffic from Google Shopping, for example if your online store is closed temporarily due to holidays or you're performing maintenance on your landing pages, don't remove the item from your product data. Provide the 'out of stock' value in the 'availability' attribute instead. Once the item is available again, just change the 'availability' value back to 'in stock'. Your item may start serving quicker this way since we do not need to reprocess it.
  • For variations of the same product, we recommend that you submit URLs that pre-select the variant that the user clicked on in Google Shopping.
  • The URL provided in the 'link' attribute must start with 'http://' or 'https://' and use the domain name that you verified either when you created your Merchant Center account or in the Website Verification tab.
  • Any symbols used must be replaced by URL encoded entities (e.g. comma = %2C).
mobile link [mobile_link] – Mobile landing page URLs

You can use this attribute to provide links to mobile-optimised versions of the landing pages for your products. Mobile-optimised landing pages are pages optimised for smartphones and feature phones. Providing a mobile-optimised link separate from the URL that you provide in the ‘link’ attribute allows for an improved user experience by ensuring that your mobile-optimised site is properly displayed to shoppers browsing on a mobile device. It may also reduce landing page loading latencies, and you’ll also see additional reporting in Merchant Center for potential issues with your mobile-optimised landing pages.

When to include: Recommended if you have mobile-optimised versions of your landing pages.

Type URL (this must include the http:// portion)
Character limit 2,000
Text/Tab-delimited http://www.example.co.uk/asp/sp.asp?cat=12&id=1030
XML <g:mobile_link>http://www.example.com/asp/sp.asp?cat=12&amp;id=1030</g:mobile_link>

Important:

  • The same rules as for the ‘link’ attribute apply.
  • The URL contained in this attribute is a direct link to your product page. If you specify the ‘adwords redirect’ attribute, it must redirect to the same website as the one specified in the 'mobile link' attribute only if the request is from a mobile device. To specify a mobile URL in your ‘adwords redirect’ attribute, use an {ifmobile} parameter in the attribute. If you don’t specify the 'adwords redirect' attribute, the user is directly sent to the URL specified in the 'mobile link' attribute if they are on a mobile device. Learn more about the 'adwords redirect' attribute.
  • Learn more about creating mobile-optimised websites.
image link [image_link] – URL of an image of the item

This is the URL of the main image for a product and is the first image that users see on product detail pages.

If you have various images of the item, submit the main image using this attribute, and include all other images in the 'additional image link' attribute.

Image size:

  • Submit the largest, highest resolution full-size image that you have for the product, up to a file size of 4 MB.
  • Image dimensions must be greater than 32 x 32 pixels, with the total image size not exceeding 64 megapixels.
  • We recommend images that are at least 800 pixels in height and width.
  • Do not scale up images or submit thumbnails. We recommend that the product take no less than 75% but no more than 90% of the full image
  • For clothing products we require images with dimensions of at least 250 x 250 pixels.

When to include: Required for all items.

Type URL. (Must start with 'http://' or 'https://'.)
Character limit 2,000
Text/Tab delimited http://www.example.co.uk/image1.jpg
XML (Feeds) <g:image_link>http://www.example.com/image1.jpg</g:image_link>

We will remove items from Google Shopping that do not comply with our image policy requirements. Please see our policy for more details. Images that do not meet our guidelines, stated below under Requirements and Recommendations, may result in decreased performance.

Requirements:

  • You must have an image of an item in order to submit it
  • The following types of images are not allowed:
      • Placeholder or incorrect product images
      • Generic images, graphics or illustrations that are not the actual product images, except for products in the 'Hardware' (632) or 'Vehicles and parts' (888) categories
      • Single colour images that are only a square of colour, except for products in the 'Vehicle Paint' (3812), 'Craft Paint, Ink & Glaze' (505378) and 'Painting Consumables' (503740) categories
      • Images containing promotional elements (e.g. calls to action, such as "buy"; service-related information, such as extended warranty; free delivery; price information; promotional adjectives, such as "best, cheap"; condition or compatibility, such as new, 2-piece, adaptable) or names and/or logos of merchants regardless of whether the above mentioned elements overlay the product. This also applies to watermarks with promotional elements or names and/or logos of merchants.
      • Images containing obstructing content (e.g. watermarks, brand names and/or logos) that overlay the product being sold
      • Images that include borders
      • Images of a bundle that do not show the entire bundle
      • Images of multipacks that do not display a single unit of the product

      Landing pages with no image, or placeholder images that do not show the actual product, are also not allowed.

      Make sure that the image that you provide for each item matches the values provided in the 'colour', 'pattern' and 'material' attributes, or your item might be disapproved.

Recommendations:

Images that do not follow our recommendations will result in decreased performance

  • For all other countries and categories: If you cannot provide the appropriate images to submit your items as variants, you may list your variant products as a single item with multiple values for the variant attributes and provide the available image.
  • The image must accurately display the product and include minimal or no product staging.
  • For variants based on 'colour', each individual variant item that you submit must have an image that displays the product in a single colour.
  • The main image should be taken on a solid white, grey or light-coloured background.
  • The main image of a product should include a main and/or clear view of the product being sold. Additional views of the product (other than the main view) should be submitted in the 'additional image link' attributes.

Formatting:

  • The accepted image formats are non-animated GIF (.gif), JPEG (.jpg/.jpeg), PNG (.png), BMP (.bmp) and TIFF (.tif/.tiff) and the file extensions for these images should correspond to their format.
  • The accepted URL protocols are 'http' and 'https'. Any symbols used within the image URL must be replaced by URL encoded entities (e.g. comma = %2C).
  • We recommend that you submit stable URLs for your images and only update the URL if the actual image of the product has changed. This is especially important if you use a content delivery network to host images, and it will ensure that we can crawl your images correctly.

Cropping:

As we experiment with the best display options for the Product Listing Ad format, we might automatically crop your image to focus more on the product. To opt out of this feature, contact us.

additional image link [additional_image_link] – Additional URLs of images of the item

If you have additional images for this item, include them in this attribute. For example, if you have images that show the product from a different angle than the main image or if you have images of the packaging or the product in various settings.

You can include up to 10 additional images per item by including the attribute multiple times. For tab-delimited, separate each URL by a comma. For XML, include each URL as a separate <additional_image_link> attribute.

When to include: For all items with multiple images.

Type URL (Must include the http:// portion.)
Character limit 2,000
Text/Tab-delimited http://www.example.co.uk/image1.jpg
XML <g:additional_image_link>
http://www.example.co.uk/image1.jpg
</g:additional_image_link>

Important:

  • The same rules as for image link apply.
condition [condition] – Condition or state of the item

There are only three accepted values:

  • 'new': The product is brand new and has never been used. It's in its original packaging which has not been opened.
  • 'refurbished': The product has been professionally restored to working order, is "as new" and comes with a warranty. The packaging may or may not be the original packaging. This is sometimes referred to as "remanufactured".
  • 'used': If the two previous values don't apply. For example, if the product has been used before, is a refilled printer cartridge or the original packaging has been opened or is missing.

When to include: Required for all items.

Type Three predefined values accepted:
  • 'new'
  • 'used'
  • 'refurbished'
Text/Tab-delimited used
XML <g:condition>used</g:condition>

Important:

  • If you are submitting the attribute names in English, you must provide the attribute values in English as well.

Availability & Price

The attributes in this section are required in order to specify the availability and prices of your items. The availability and prices of your items can change quite frequently, and you need to make sure that Google is notified of these changes as they happen. You can find advice on providing the most up-to-date or fresh data here.

We regularly check these attributes, and if the values provided in these attributes are found to be different from the information presented on your website, we will disapprove your items and they won't appear on Google Shopping. Please see our policies for more details.

availability [availability] - Availability status of the item

Providing the freshest availability status of your item is important so that users know that the item will be delivered in a timely manner.

The availability attribute has three accepted values:

  • 'preorder': You’re currently taking orders for this product, but it’s not yet been released. You can use the attribute ‘availability date’ to indicate the day that the product becomes available for delivery.
  • 'in stock': You’re currently accepting orders for this product and can fulfil the purchase request. You are certain that the item will be shipped (or be in transit to the customer) in a timely manner because it is available for sale, such as it’s in stock or available for order.
  • 'out of stock': You’re currently not accepting orders for this product, or the product is not available for purchase.

When to include: Required for all items.

Type Three predefined values accepted:
  • 'in stock'
  • 'out of stock'
  • 'preorder'
Text/Tab-delimited In stock
XML (Feeds) <g:availability>in stock</g:availability>

Important:

  • Your landing page should indicate the availability status of your item for the countries that you are targeting.
  • If you no longer sell an item and don't plan to sell it again in the future, you should remove the item from the feed entirely.
  • If you are submitting the attribute names in English, you must provide the attribute values in English as well.
  • If you have out-of-stock items or don’t want to receive traffic from Google Shopping, for example if your online store is closed temporarily due to holidays, don't remove the item from your product data. Provide the ‘out of stock’ value instead. Once the item is available again, just change the ‘availability’ value back to ‘in stock’. Your item may start serving quicker this way since we do not need to reprocess it.
  • For ‘preorder’ items that do not yet have a unique product identifier, submit ‘identifier exists’ with a value of FALSE.
  • Read our Landing Page Content policy carefully for the availability requirement on your landing page.
availability date [availability_date] – The day a pre-ordered product becomes available for delivery

If you are accepting orders for products that are available for preorder, use this attribute to indicate when the product becomes available for delivery.

When to include: Recommended for items with the ‘preorder’ value for the ‘availability’ attribute.

Type Date specified by the format (YYYY-MM-DD) followed by the letter ‘T’, the time of the day when availability begins, followed by an expression of the time zone, as defined by the ISO 8601 standard.
Character limit 25
Text/Tab-delimited 2014-12-25T13:00-0800
XML <g:availability_date>2014-12-25T13:00-0800</g:availability_date>
price [price] – Price of the item

The price of the item has to be prominent on the landing page. If multiple items are on the same page with multiple prices, it has to be straightforward for the user to find the correct item and corresponding price.

When to include: Required for all items.

Type Number
Text/Tab-delimited 15.00 GBP
XML <g:price>15.00 USD</g:price>

Important:

  • For the US, don't include tax in the price. For all other countries except Canada and India, value-added tax (VAT) has to be included in the price.
  • The price must include a currency according to ISO 4217 Standard.
  • For products on sale, we recommend including the 'sale price' attribute and submitting the regular price (before sale) in the 'price' attribute. In this case, the sale price (instead of the regular price) must be straightforward to find on the page.
  • You must not include a price value of 0.00 for your items. Items with zero prices may not appear in the search results (Note: The only exception is mobile phones or tablets bundled with service contracts as detailed below).
  • For mobile phones or tablets, a subsidised price with a service contract is allowed. In this case, the price can be as low as £0. The items must be submitted with the ‘google product taxonomy’ value of ‘Electronics > Communications > Telephony > Mobile Phones’ for phones and 'Electronics > Computers > Tablet Computers' for tablets, and include the phrase “only with contract” (or equivalent language) in the ‘title’.
  • In the US, payment schemes featuring multiple instalments are allowed for mobile phones and tablets. In this case, submit the price of the down payment as your ‘price’. The ‘title’ must include the phrase “with payment plan” (or equivalent language). For feeds targeting Brazil, please use the ‘instalment’ attribute to submit mobile phones or tablets with multiple instalments. Mobile phones or tablets with these types of payment schemes are not allowed in other target countries.
  • Read our Pricing and Payments policy for further requirements and our Landing Page Content policy for the price requirements on your landing page.

Please note that you can use unit-pricing and 'instalment' attributes to submit price-related information for applicable target countries.

sale price [sale_price] – Advertised sale price of the item

Use this attribute to submit the advertised sale price of the item. Learn more about submitting sale price information.

When to include: Recommended for items on sale. If your item is on sale and you don’t include this attribute, the sale price must be updated as the value in the 'price' attribute.

Format Number
Text/Tab-delimited 15.00 GBP
XML <g:sale_price>15.00 GBP</g:sale_price>

Important:

  • You must still include the 'price' attribute in your feed, which must reflect the non-sale price for which you have previously sold the item for.
  • The price must include a currency.
  • You must not include a price value of GBP 0.00 for your items. Items with zero prices may not appear in the search results.
  • If you are submitting the 'sale price' attribute and do not also submit the 'sale price effective date' attribute, the 'sale price' will be used for your item.
  • Read our Landing Page Content policy carefully for the sale price requirements on your landing page.
sale price effective date [sale_price_effective_date] – Date range during which the item is on sale

Used in conjunction with sale price. This attribute indicates the date range during which the sale price applies. Learn more about submitting sale price information.

When to include: Recommended for items which use the 'sale price' attribute.

Format Start and end dates separated by a forward slash (/). The start is specified by the format (YYYY-MM-DD), followed by the letter ‘T’, the time of the day when the sale starts, followed by an expression of the time zone for the sale, as defined by the ISO 8601 standard. The end date should be in the same format.
Character limit 51
Text/Tab-delimited 2011-03-01T13:00-0800/2011-03-11T15:30-0800
XML <g:sale_price_effective_date>2011-03-01T13:00-0800/2011-03-11T15:30-0800</g:sale_price_effective_date>

Important:

  • If you are submitting the 'sale price' attribute and do not also submit the 'sale price effective date' attribute, the 'sale price' will be used for your item.

Unique Product Identifiers

Unique product identifiers are product codes associated with an individual product or product variant. They uniquely and completely identify a product in the global marketplace. When you submit these identifiers, you help us to make your ads richer, and you also make it easier for users to find the product that you're selling. Products submitted without unique product identifiers are difficult to classify and may not be able to take advantage of all Google Shopping features. Learn more about unique product identifiers. 

Submit unique product identifiers with a combination of these attributes:

  • Global Trade Item Numbers (GTINs) submitted through the 'GTIN' attribute. GTINs include UPC, EAN (in Europe), JAN (in Japan) and ISBN. Learn how to find your product's GTIN;
  • Manufacturer Part Number (MPN) submitted through the 'MPN' attribute; and,
  • The product's brand name in the 'brand' attribute.

These products won't have unique product identifiers:

  • Custom goods or one-of-a-kind items, like custom t-shirts, art and perishables.
  • Goods produced before unique product identifiers were introduced, like vintage goods, antiques, books published before 1970 and other special items.

Unique Product Identifier Rules

For Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey, unique product identifier attributes are recommended.

For Australia, Brazil, the Czech Republic, France, Germany, Italy, Japan, the Netherlands, Spain, Switzerland, the UK and the US, you'll use the following set of rules to provide the correct identifiers for each of your products.

'gtin' and 'brand' are strictly required* for products when: 

  1. the 'brand' is a designated brand and
  2. the condition is 'new'.

*Products where 'availability' is 'pre-order' are exempted from this; you may use one of the rules below.

'mpn' is strongly recommended.

For all products that do not meet these criteria, refer to the following rules:

Clothing

'brand' is required.

Additionally, for the categories listed below, you must submit one of either 'gtin' or 'mpn':

  • 'Clothing & Accessories > Shoes'
  • 'Clothing & Accessories > Clothing Accessories > Sunglasses'
  • 'Clothing & Accessories > Handbags, Wallets & Cases > Handbags'
  • 'Clothing & Accessories > Jewellery > Watches'

Whenever GTINs are available, we strongly recommend providing them in the 'gtin' attribute.

Media and software 'gtin' is required.
All other categories

At least 2 of the following 3 identifiers are required: 'brand', 'gtin' and 'mpn'.

Whenever GTINs are available, we strongly recommend providing them in the 'gtin' attribute.

No unique product identifiers exist Where unique product identifiers are required but no such identifier exists for an item (e.g. custom goods), submit the 'identifier exists' attribute with a value of FALSE.

If you don't provide unique product identifiers when they exist, your items may be removed from Google Shopping.

In the future, GTIN will become a requirement for all products that have them, but we'll let you know in advance before we make that change.

gtin [gtin] – Global Trade Item Number (GTIN) of the item

Use the 'GTIN' attribute to submit Global Trade Item Numbers (GTINs) in one of the following formats:

  • 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-10s are deprecated and should be converted to ISBN-13.
  • ITF-14 (for multipacks/GTIN-14): 14-digit number like 10856435001702.

When to include: Refer to the Unique Product Identifier Rules for your target country.

Type 8-, 12- or 13-digit number (UPC, EAN, JAN or ISBN)
Character limit 50
Text/Tab-delimited TN34 3ES
XML (Feeds) <g:gtin>0606449056822</g:gtin>

Important:

  • We accept 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 reserved (GS1 prefix ranges 140-199, 952-954, 956-957, 959, 970-976).
    • The GTIN is not a coupon (GS1 prefix ranges 98-99).
mpn [mpn] – Manufacturer Part Number (MPN) of the item

Manufacturer Part Numbers (MPNs) are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer.

When to include: Refer to the Unique Product Identifier Rules for your target country.

Type Alphanumerical characters
Character limit 70
Text/Tab-delimited GO12345OOGLE
XML (Feeds) <g:mpn>GO1234568OOGLE</g:mpn>

Important:

  • MPNs are assigned by a manufacturer. A merchant-assigned identifier is not an appropriate value for this attribute, except in cases where the seller is also the manufacturer of the item.
  • MPNs should be specific to a single unique product. For example, different colours of a product should have different MPNs.
brand [brand] – Brand of the item

When to include: Refer to the Unique Product Identifier Rules for your target country.

Type Text
Character limit 70
Text/Tab-delimited Acme
XML (Feeds) <g:brand>Acme</g:brand>

Important:

  • You must not provide your shop name as the brand unless you manufacture the product.
identifier exists [identifier_exists] – Submit custom goods

In categories where unique product identifiers are required, merchants must submit the ‘identifier exists’ attribute with a value of FALSE when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN and brand.

When to include: Required according to the Unique Product Identifier Rules for all target countries except for Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey. This attribute is recommended for Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey.

Type Boolean: TRUE or FALSE
Text/Tab-delimited FALSE
XML <g:identifier_exists>FALSE</g:identifier_exists>

Important:

  • When the attribute is not specified, the default value is TRUE.

Examples of unique product identifier submissions:

Books

  • Rare old books: Submit 'identifier exists' with a value of FALSE.
  • New books (published after 1970): Provide ISBN in the 'GTIN' attribute.

Custom Goods

  • Handmade goods: Submit 'identifier exists' with a value of FALSE.
  • Antique goods: Submit 'identifier exists' with a value of FALSE.

Clothing

  • Mass-produced clothing: Provide 'brand'. Also provide 'gtin' where available, or 'mpn' otherwise.
  • Custom clothing: Submit 'identifier exists' with a value of FALSE.

Multipacks

  • Manufacturer-defined multipack: Follow the Unique Product Identifier Rules as described above. This multipack should be treated as a single item.
  • Merchant-defined multipack: Follow the Unique Product Identifier Rules as described above for the individual base item in the multipack. Use the 'multipack' attribute to submit the number of items available in your multipack.

Toner & Inkjet Cartridges

  • For compatible cartridges in the 'Electronics > Print, Copy, Scan & Fax > Printer, Copier & Fax Machine Accessories > Printer Consumables > Toner & Inkjet Cartridges' category: submit the Unique Product Identifiers of the manufacturer who actually built the printer cartridge.

Bundles

  • A manufacturer-defined bundle (e.g. a camera body with a lens): Follow the Unique Product Identifier Rules as described above. This bundle should be treated as a single item.
  • A merchant-defined bundle (a custom grouping of different products defined by the merchant and sold together for a single price): Follow the Unique Product Identifier Rules as described above for the main item in the bundle. Please see the section for the 'is bundle' attribute for more information.

Detailed Product Attributes and Item Groupings

Many products like shoes, furniture and electronics come in a variety of colours, materials, sizes and so on. To make sure that we can accurately display these products to users, you may need to submit detailed product attributes for each unique product style. You'll also need to group products together with an item group id in cases where the underlying product is part of a group that varies by one or more attributes, like colour. Each different version of a product in one of these groupings are sometimes referred to as a product variant.

Example of a single item with detailed product attributes:

You are selling a leather chair in a single colour and material. Use detailed product attributes to describe the colour (e.g. brown) and material (e.g. leather) of the item.

Example of multiple items with detailed product attributes grouped by an item group id:

You are selling a T-shirt that is available in multiple colours and sizes. Use detailed product attributes to describe the different colours and sizes of each unique item and then group them together with an item group id that is unique to that item group.

Tip

Not all types of product variants are supported by Google Shopping. If you sell build-to-order custom goods or products that vary by attributes not supported by Google Shopping, make sure that you review our best practices for submitting unsupported variant products.

Detailed Product Attributes

We recommend that you provide the following product information for each unique item that you submit if it exists, is relevant, and if the information fits into the accepted values for the detailed product attributes: 'colour', 'size', 'pattern', 'material', 'age group', 'gender', 'size type' and 'size system'.

For Brazil, France, Germany, Japan, the UK and the US, the attributes 'colour', 'age group' and 'gender' are required for the 'Clothing & Accessories' category and the 'size' attribute is required for the categories 'Clothing & Accessories > Clothing' and 'Clothing & Accessories > Shoes'.

Examples of products that should use detailed product attributes:

  • A T-shirt may have colour, material and size
  • A sofa may have material, pattern and colour
  • A mobile phone may have a colour
  • A toy may have an age group

Important:

  • When naming your item using the 'title' attribute, we recommend that you include all relevant detailed product attributes as part of the title. This will help users to identify the correct version of the product that they are looking for.
  • Make sure that the image that you provide for each item matches the values provided in the 'colour', 'pattern', and 'material' attributes, or your item might be disapproved.
  • If you have several variations of one product, do not provide multiple values for detailed product attributes in a single item. Instead, create an individual item for each variant and group the items together using the 'item group id' attribute. If you do not do this, your items might be disapproved.
  • See examples of how detailed product attributes look in product data.

Item Groupings

For Brazil, France, Germany, Japan, the UK and the US, item groupings are required for all items with variants that use these detailed product attributes: 'colour', 'size', 'pattern', 'material', 'age group', 'gender', 'size type' and 'size system'. Item groupings are recommended for all other countries.

Use the 'item group id' attribute with a common value across the group. Each distinct item group must have a unique value for 'item group id'.

Examples of products that should use item groupings:

  • A T-shirt available in several colours, patterns and sizes
  • A sofa available in different materials, patterns and colours
  • A mobile phone available in different colours

See examples of how detailed product attributes look in product data.

Important:

  • If you do not group product variants using the 'item group id' attribute where it is applicable, we may disapprove your items. If variants in your item group differ by more than one attribute, you must submit one item per product variant combination. For example, if a T-shirt is offered in 4 different colours and each colour is available in 5 different sizes, you must submit a total of 20 items.
  • Each item in an item group must use the same set of detailed product attributes with a unique combination of values for these attributes. For example, if one item in an item group includes the values "Blue" and "L" for the 'colour' and 'size' attributes, all other items in the item group must have values for 'colour' and 'size', and each item must have a unique combination of values for those attributes.
  • We recommend that the 'link' attribute leads to a landing page that specifies all of the details about the variant item and, if possible, has one URL per product variant. If product variants share a landing page, the variant should be preselected in the URL. For example, if a user selects a red dress in size 10, they should be taken to a landing page, where the "red" and "size 10" options are already selected. If this is not possible, you may include identical link attribute values for each of the product variants within a group.

Tips

The following products are not considered to be variants of each other:

  • Products that vary in condition (for example, 'used' versus 'new')
  • Assorted items (for example, a suit consisting of a jacket and trousers)
  • Accessories and the related main product
  • A set of related items (for example, a set of furniture that includes a sofa and two chairs)

If you sell build-to-order custom goods that have a very large number of variants (more than 30), make sure that you review our best practices for submitting unsupported variant products. Examples of products that often fall into this case are custom jewellery and custom furniture.

item group id [item_group_id] - Shared identifier for all variants of the same product

All items that are variants of the same product must have the same item group id. If you have a "Parent SKU" that is shared by all variants of a product, you can provide that as the value for 'item group id'.

When to include: For Brazil, France, Germany, Japan, the UK and the US, required for all items with variants that use these detailed product attributes: 'colour', 'size', 'pattern', 'material', 'age group', 'gender', 'size type' and 'size system'. Recommended for all other countries.

Type Alphanumerical code
Character limit 50
Text/Tab delimited AB12345
XML (Feeds) <g:item_group_id>AB12345</g:item_group_id>

Important:

  • The 'Item group id' attribute is different from the 'ID' attribute. An 'item group ID' attribute will have common values for a group of variants, whereas the 'ID' attribute should have unique values across a group of variants and for all other items, as well.
  • The values provided for item group ID must be unique between products and only shared by items that are variants of the same product.
  • If you send us an 'item group id' attribute, we will automatically look for variant attributes. If an item uses 'Item group id', make sure that the item has at least one detailed product attribute.
colour [color] - Colour of the item

This defines the dominant colour(s) for an item. When a single item has multiple colours, you can submit up to two additional values as accent colours:

  • Combine the colours with '/' in order of prominence (dominant colour first, then at most two accent colours). For example, a black shoe with green accents should have a colour value of 'Black/Green'. In the case of non-deformable goods in Clothing such as jewellery or wooden accessories where finishes or materials are equivalent to colour, the finish or material name can be submitted in the colour attribute (e.g. 'Mahogany' vs 'Stainless Steel' vs 'Rose Gold').
  • Limit the number of colours submitted to three values per item.
  • If you're using XML, you must represent the '/' with &#47;

When to include: Required for all products in an item group that vary by colour. Required for all clothing items in feeds that target Brazil, France, Germany, Japan, the UK and the US. Recommended for all products for which colour is an important, distinguishing attribute.

Type Text
Character limit 100
Text/Tab delimited Black
XML (Feeds) <g:color>Black</g:color>

What not to include:

  • Colour values that contain numbers (e.g. '0 2 4 6 8')
  • Colour values that contain non-alphanumerical characters (e.g., '#fff000')
  • Single-letter colour values (e.g. 'G') in Latin-based languages. Single-letter colour values in Chinese-Japanese-Korean languages (e.g. '红') are acceptable.
  • Colour values that reference the product or product image (e.g. 'see image')
  • Descriptive values that are not actually valid colour names (e.g. multicolour, various, variety, see image, N/A)
  • Long colour values exceeding 40 characters
  • Long colour values that are aggregates of several other colours (e.g., RedPinkBlue). Instead:
    • If you are trying to indicate multiple colours for a single item (not product variants), specify a primary colour, optionally followed by at most two secondary colours, separated by a '/'. Here, replace RedPinkBlue with Red/Pink/Blue
    • If you are trying to indicate multiple colours for multiple similar items (product variants), submit these as separate products each with the same item group ID and a different colour value.

A note on invalid submissions:

  • If you submit a colour value that violates the syntactic rules above, we may reject the entire item at the time of feed submission.
  • We regularly verify the correctness of the attributes that you submit, including colour. If the values provided are found to be incorrect, we may remove all of your items from Google Shopping.

Important:

  • For variants, each different colour or colour combination must be submitted as its own item, in conjunction with the 'item group id'.
  • Use consistent names of colours across variants of the same product, as well as across multiple products of the same category.
  • The values that you provide may be displayed to users, so provide values that they will be able to understand.
gender [gender] – Gender of the item

When to include: Required for all products in an item group that vary by gender. Required for all clothing items in feeds that target Brazil, France, Germany, Japan, the UK and the US. Recommended for all products for which gender is an important, distinguishing attribute.

Format There are only three values accepted:
  • 'male'
  • 'female'
  • 'unisex'
Text/Tab delimited male
XML (Feeds) <g:gender>male</g:gender>

Important

  • If you are submitting the attribute names in English, you must provide the attribute values in English as well.
  • This attribute is recommended rather than required for the 'pinback buttons', 'tie clips', 'wristbands', 'shoe covers', 'shoe laces', 'spurs', 'watch bands' subcategories of 'Clothing & Accessories'.
age group [age_group] – Target age group of the item

Use the 'age group' attribute to indicate the demographic of your item.

When to include: Required for all products in an item group that vary by age group. Required for all clothing items in feeds that target Brazil, France, Germany, Japan, the UK and the US. Recommended for all products for which age group is an important, distinguishing attribute.

Format There are only five accepted values:
  • 'newborn'
  • 'infant'
  • 'toddler'
  • 'kids'
  • 'adult'
Text/Tab delimited adult
XML (Feeds) <g:age_group>adult</g:age_group>

Important:

  • The target market for each value is defined as follows:
    • Newborn: Up to 3 months old. Newborn sizes are often identified by the month (0-3) age range and/or the single value 'newborn'.
    • Infant: 3-12 months old. Infant sizes are often identified by the age range 3-12 months.
    • Toddler: 1-5 years old. Toddler sizes are often identified by the age range 12-24 months or 1-5 years.
    • Kids: 5-13 years old. All sizes within this age group have been manufactured to fit a child in that age range.
    • Adult: Typically teens or older. All sizes within this age group have been manufactured to fit an adult or teen in this age range.
  • If you are submitting the attribute names in English, you must provide the attribute values in English as well.
  • This attribute is recommended rather than required for the 'pinback buttons', 'tie clips', 'wristbands', 'shoe covers', 'shoe laces', 'spurs', 'watch bands' subcategories of 'Clothing & Accessories'.
  • If an item is not clearly just for children, it should be declared as 'adult', as only one value may be submitted per item.
material [material] – Material of the item

The material or fabric that a product is made out of. For example, a high-heeled shoe might have values of "Leather", "Denim", "Suede", etc.

When to include: Required for all products in an item group that vary by material. Recommended for all products for which material is an important, distinguishing attribute.

Type Text
Character limit 200
Text/Tab delimited Leather
XML (Feeds) <g:material>Leather</g:material>

Important:

  • For variants, each item that differs in 'material'' must be submitted as its own item, in conjunction with the 'item group id'.
  • The values that you provide may be displayed to users, so provide values that they will be able to understand.
  • If you are trying to indicate multiple materials for a single item (not product variants), specify a primary material, optionally followed by at most two secondary materials, separated by a '/'. For example, instead of CottonPolyesterElastane, use cotton/polyester/elastane.
pattern [pattern] - Pattern/Graphic of the item

The pattern or graphic print featured on a product. For example, a t-shirt might have a logo of a sports team and have pattern values of "Bears", "Tigers", etc. A dress might come in two prints and have pattern values of "Polka Dot", "Striped", "Paisley", etc.

As a rule of thumb, if a user can choose to select different patterns on the landing page of your product, include all variant items in the same item group. Otherwise, use separate item groups.

When to include: Required for all products in an item group that vary by pattern. Recommended for all products for which pattern is an important, distinguishing attribute.

Type Text
Character limit 100
Text/Tab delimited Striped
XML (Feeds) <g:pattern>Striped</g:pattern>

Important:

  • For variants, each item that differs in 'pattern' must be submitted as its own item, in conjunction with the 'item group id'.
  • The values that you provide may be displayed to users, so provide values that they will be able to understand.
size [size] – Size of the item

This indicates the size of a product. For 'Clothing & Accessories' items, you can also submit the 'size type' and 'size system' attributes to provide more details about your sizing.

When to include: Required for all products in an item group that vary by size. Required for all clothing items in the 'Clothing & Accessories > Clothing' and 'Clothing & Accessories > Shoes' product categories in product data that targets Brazil, France, Germany, Japan, the UK and the US. Recommended for all products for which size is an important, distinguishing attribute.

Type Text

If you are targeting the US, refer to the list of recognised values (US only)

For all other countries, see example sizes
Character limit 100
Text/Tab delimited XL
XML (Feeds) <g:size>XL</g:size>

Important:

  • For variants, each different size or size combination must be submitted as a separate item, in conjunction with the 'item group id'. Visit submitting apparel products for more details.
  • If sizes contain multiple dimensions, condense them into one value (e.g. "16/34 Tall" for neck size 16 inches, sleeve length 34 inches and "Tall" fit).
  • Use consistent size values across variants of the same product, as well as across multiple products in the same category. For example, within a group of T-shirts, use "S", "M" and "L" as sizes, not "S", "Medium" and "Lrg".
  • You may use the same image for size variants if specific images are not available but we recommend that the 'link' attribute leads to a page which specifies all the details about the variant item.
  • The values that you provide may be displayed to users, so provide values that they will be able to understand.
  • You can provide additional details about your sizing in the text string. For US sizes, for example, you can provide "3.5 Kid" or "3.5 Toddler".
  • If your item is one size fits all or one size fits most, you can use the phrase 'one size', 'OS', 'one size fits all', 'OSFA', 'one size fits most', or 'OSFM' in this attribute.

Sample Sizing Values

Sizing values can be difficult to represent across different types of clothing products. You are not required to provide these exact values, but it may be helpful for you to standardise the size values of your clothing products. You can also use the 'size type' and 'size system' attributes to provide more information about the sizing of your products.

Tops, Outerwear and Dresses

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34

Bottoms

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34
23, 24, 26, 27, 28, 29, 30, 32, 34, 36, 38, 40, 42, 44
For Trousers: 24x30, 24x32, 24x34

Plus, Petite, Big, Tall, Inside Leg, etc.

When an item applies to a special size group, such as Plus, Petite, Maternity or Big and Tall, use the 'size type' attribute.
When an item includes an inside leg measurement, consider using this format for the size: 30 Short, 30 Regular, 30 Long

Shoes

For US: 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.5, 13, 13.5, 14, 14.5, 15, 15.5, 16. Note: When a shoe is available in different width sizes, an indication is recommended: 9.5 M, 8 W, 12 N.
For Europe: 37, 38, 39, 40, 41, 42, 43, 44, 45
size type [size_type] – Size type of the item

Use this attribute to indicate the cut of your item.

When to include: Recommended for all clothing items.

Format There are five accepted values:
  • 'regular'
  • 'petite'
  • 'plus'
  • 'big and tall'
  • 'maternity'
Text/Tab delimited petite
XML (Feeds) <g:size_type>petite</g:size_type>

Important:

  • The ‘size type’ should match the manufacturer’s sizing of the item.
  • When the attribute is not specified, the default value is ‘regular’.
size system [size_system] – Size system of the item

Use this attribute to indicate the country’s sizing system in which you are submitting your item.

When to include: Recommended for all clothing items.

Format There are 11 accepted values:
  • US
  • UK
  • EU
  • DE
  • FR
  • JP
  • CN (China)
  • IT
  • BR
  • MEX
  • AU
Text/Tab-delimited GB
XML <g:size_system>US</g:size_system>

Important:

  • When the attribute is not specified, the default values are based on your target country. In order to ensure an accurate representation of the sizing of your item, we recommend this attribute for all clothing items.

Tax & Delivery

Taxes and delivery are an important part of the total cost of items. In fact, delivery cost is the most common reason for users abandoning their shopping choices. The 'tax' attribute is only applicable to feeds targeting the US. For all countries, please review our tax policy for more information on whether or not value-added tax (VAT) has to be included in the price of an item.

There are three ways to specify tax (US only) and delivery costs:

  1. Settings in the Merchant Center: We offer various ways to specify tax and delivery costs. Find out more about account-level tax settings. You can also use account-level delivery settings to create comprehensive delivery configurations for most delivery models. These settings allow you to use anything from simple flat rates to more complex custom models. Account-level settings can be based on product attributes such as ‘price’, ‘delivery weight’ or ‘delivery label’, or – in some countries – based on delivery locations such as state, city or postcode. Find out more about account-level delivery settings.
  2. Attributes in your product data: By using the tax and delivery attributes below, you can also model complex tax and delivery cost structures.
  3. Combination of the two: You can specify default tax and delivery information in Merchant Center and then override those defaults for certain products by specifying the attributes below. Feed-level information always overrides account-level settings.

You're required to use one of the ways above to specify tax in the US, and delivery information in the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan.

If you can’t provide accurate tax or delivery information that complies with local laws, provide tax and delivery costs that match or overestimate the average tax and delivery rate users visiting your site from Google Shopping would pay. For more information, please review our delivery policy.

Remember that no matter what tax amount you provide for Google Shopping, you're still responsible for collecting the appropriate amount of tax from your customers.

tax [tax]

The tax attribute is an item-level override for merchant-level tax settings as defined in your Google Merchant Center account. This attribute is only accepted in the US. If your feed targets a country outside of the US, please do not use this attribute.

This attribute has four parts:

  • country (optional): The country an item is taxed in according to ISO 3166 standard. (At the moment, it's always 'US'.)
  • Geographic area. There are three sub-attributes supported to specify a geographic area where a tax rate applies. Only one should be used per each tax entry.
    • region (optional): The geographic region that a tax rate applies to. In the US, the two-letter state abbreviation (e.g., CA).
    • postal code (optional): The postal code range that a tax rate applies to, e.g., in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460, 94*-95*.
    • location id (optional): The numeric id of a location that a tax rate applies to as defined in the AdWords API. Currently supported for State and City in the US. For example, for San Francisco: 1014221
  • rate (required): The tax rate as a percent of the item price, i.e., a number as a percentage
  • tax_ship (optional): Boolean value for whether you charge tax on shipping, 'y' for yes or 'n' for no - the default value is 'n'.

You can include this attribute up to 100 times to specify taxes for each state individually. If you decide to submit it explicitly for each state, make sure to cover every state (even the states where you do not charge tax). Note you can also specify that you charge no tax for a state by setting the rate as 0.

When to include: For items in feeds that target the US, use this attribute if you want to specify taxes for a particular item, or you want to override the default tax costs specified in the Merchant Center settings. If you do not provide tax information using one of these methods for each item, your items won’t show up in Google Shopping results.

Type Each tax attribute group can consist of four sub-attributes:
 
Name Requirement Description Examples
country optional The country an item is taxed in (as an ISO 3166 country code). The default value for this attribute is your feed's target country. US

region or postal code or location id

 

Only one should be used per each tax entry

optional The geographic area that a tax rate applies to. Each sub-attribute option has specific values that are accepted. CA or 94043 or 1014044
rate required The tax rate as a percent of the item price, i.e., number, as a percentage 5.00
tax_ship optional Boolean value for whether you charge tax on shipping, 'y' for yes or 'n' for no - the default value is 'n' y
Note: You can submit multiple values for this attribute.
Text/Tab delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the tax attribute, you’ll tell us what sub-attribute values to expect by the way you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case tax) followed by the sub-attributes you’ll submit in parenthesis separated by colons. The sub-attribute rate is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, rate, tax_ship).

Submit sub-attributes values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon, and each tax attribute group with a comma. Do not enclose the values for this attribute within quotations. All colons, even for blank values, are required.

Attribute name:
tax(country:postal code:rate)

Attribute values:
US:94114:8.75
US:94*:8.75
US:94002-95460:8,US:10*-12*:9

Attribute name:
tax(country:location id:rate:tax_ship)

Attribute values:
US:1012873:0:
US:1025433:6:y,US:1014212:9:y

Attribute name:
tax

Attribute values:
US::0:
US:CA:8.25:y,US:OR:0:

XML The four sub-attributes are country, geographic area (region, postal code, or location id), rate, and tax ship. Include each tax attribute group as a separate attribute.
<g:tax>
   <g:country>US</g:country>
   <g:region>MA</g:region>
   <g:rate>5.00</g:rate>
   <g:tax_ship>y</g:tax_ship>
</g:tax>

Important:

  • Note: If country is not included, we assume the rate is for the target country of the item. If region, postal code, or location id is included, then country must be included as well. If region, postal code, or location id is not included, the rate is for the entire country.
delivery [delivery]

Please select a country from the drop-down menu above to see delivery information.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. AU
region or postcode or location ID or location group name

Only one should be used for each delivery entry
optional The geographical area where a delivery rate applies. In Australia, for 'region', use the two or three letter state abbreviation. Each sub-attribute option has specific values that are accepted. NSW or 2000 or 20035 or East
service optional The service class Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:region:price)

Attribute values:
AU:NSW:6.49 AUD
AU:NSW:0 AUD, AU:QLD:15.99 AUD

Attribute name:
delivery(country:postal code:service:price)

Attribute values:
AU:2000::0 AUD
AU:2000:Ground:22.59 AUD,AU:4*:Ground:7.78 AUD

Attribute name:
delivery(price)

Attribute values:
6.49 AUD

Attribute name:
delivery

Attribute values:
AU:::6.49 AUD
AU:NSW:Ground:0 AUD,AU:QLD:Ground:13.12 AUD

XML The four sub-attributes are country, region, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>AU</g:country>
   <g:region>NSW</g:region>
   <g:service>Ground</g:service>
   <g:price>5.95 AUD</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. JP

region or location ID or location group name

Only one should be used for each delivery entry

optional

‘postcode’ is not supported in Japan
The geographical area to which a delivery rate applies. For Japan, for region, the Japanese Industrial Standard JIS X 0401 code of the prefecture.

Each sub-attribute option has specific values that are accepted.
23 or 20636 or southern prefectures
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 1000 JPY
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:location id:price)

Attribute values:
JP:20636:1000 JPY
JP:20636:0 JPY, JP:20637:1000 JPY

Attribute name:
delivery(country:region:service:price)

Attribute values:
JP:23:Standard:1000 JPY
JP:23:Express:0 JPY,JP:37:Standard:500 JPY

Attribute name:
delivery(country:location group name:service:price)

Attribute values:
JP:southern prefectures::0 JPY
JP:tokyo and surrounding::500 JPY,JP:close to warehouse:Standard:750 JPY

Attribute name:
delivery(price)

Attribute values:
6.49 JPY

Attribute name:
delivery

Attribute values:
JP:::6.49 JPY
JP:23:Standard:0 JPY,JP:37:Express:2000 JPY

XML The four sub-attributes are country, geographical area (region, location ID or location group name), service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>JP</g:country>
   <g:region>23</g:region>
   <g:service>Standard</g:service>
   <g:price>1000 JPY</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. FR
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
FR:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
FR:Standard:12.99 EUR
FR::17.80 EUR,FR:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
FR:::6.49 EUR
FR::Standard:0 EUR,FR::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>FR</g:country>
   <g:service>Standard</g:service>
   <g:price>4.95 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. DE
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
DE:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
DE:Standard:12.99 EUR
DE::17.80 EUR,DE:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
DE:::6.49 EUR
DE::Standard:0 EUR,DE::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>DE</g:country>
   <g:service>Standard</g:service>
   <g:price>4.95 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. NL
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
NL:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
NL:Standard:12.99 EUR
NL::17.80 EUR,NL:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
NL:::6.49 EUR
NL::Standard:0 EUR,NL::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>NL</g:country>
   <g:service>Standard</g:service>
   <g:price>4.95 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. ES
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
ES:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
ES:Standard:12.99 EUR
ES::17.80 EUR,ES:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
ES:::6.49 EUR
ES::Standard:0 EUR,ES::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>ES</g:country>
   <g:service>Standard</g:service>
   <g:price>4.95 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. IT
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
IT:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
IT:Standard:12.99 EUR
IT::17.80 EUR,IT:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
IT:::6.49 EUR
IT::Standard:0 EUR,IT::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>IT</g:country>
   <g:service>Standard</g:service>
   <g:price>4.95 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. GB
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 4.95 GPB
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
GB:6.49 GBP

Attribute name:
delivery(country:service:price)

Attribute values:
GB:Standard:12.99 GBP
GB::17.80 GBP,GB:Express:25.99 GBP

Attribute name:
delivery(price)

Attribute values:
6.49 GBP

Attribute name:
delivery

Attribute values:
GB:::6.49 GBP
GB::Standard:0 GBP,GB::Express:13.12 GBP

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>GB</g:country>
   <g:service>Royal Mail</g:service>
   <g:price>4.12 GBP</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. BR
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 11.42 BRL
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
BR:6.49 BRL

Attribute name:
delivery(country:service:price)

Attribute values:
BR:Standard:12.99 BRL
BR::17.80 BRL,BR:Express:25.99 BRL

Attribute name:
delivery(price)

Attribute values:
6.49 BRL

Attribute name:
delivery

Attribute values:
BR:::6.49 BRL
BR::Standard:0 BRL,BR::Express:13.12 BRL

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>BR</g:country>
   <g:service>Standard</g:service>
   <g:price>11.42 BRL</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. CZ
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 124.42 CZK
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
CZ:6.49 CZK

Attribute name:
delivery(country:service:price)

Attribute values:
CZ:Standard:12.99 CZK
CZ::17.80 CZK,CZ:Express:25.99 CZK

Attribute name:
delivery(price)

Attribute values:
6.49 CZK

Attribute name:
delivery

Attribute values:
CZ:::6.49 CZK
CZ::Standard:0 CZK,CZ::Express:13.12 CZK

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>CZ</g:country>
   <g:service>Standard</g:service>
   <g:price>124.42 CZK</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. CH
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 6.15 CHF
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
CH:6.49 CHF

Attribute name:
delivery(country:service:price)

Attribute values:
CH:Standard:12.99 CHF
CH::17.80 CHF,CH:Express:25.99 CHF

Attribute name:
delivery(price)

Attribute values:
6.49 CHF

Attribute name:
delivery

Attribute values:
CH:::6.49 CHF
CH::Standard:0 CHF,CH::Express:13.12 CHF

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>CH</g:country>
   <g:service>Standard</g:service>
   <g:price>6.15 CHF</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. CA
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 CAD
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
CA:6.49 CAD

Attribute name:
delivery(country:service:price)

Attribute values:
CA:Standard:12.99 CAD
CA::17.80 CAD,CA:Express:25.99 CAD

Attribute name:
delivery(price)

Attribute values:
6.49 CAD

Attribute name:
delivery

Attribute values:
CA:::6.49 CAD
CA::Standard:0 CAD,CA::Express:13.12 CAD

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>CA</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 CAD</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. in:
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 INR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
IN:6.49 INR

Attribute name:
delivery(country:service:price)

Attribute values:
IN:Standard:12.99 INR
IN::17.80 INR,IN:Express:25.99 INR

Attribute name:
delivery(price)

Attribute values:
6.49 INR

Attribute name:
delivery

Attribute values:
IN:::6.49 INR
IN::Standard:0 INR,IN::Express:13.12 INR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>IN</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 INR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. RU
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 RUB
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
RU:6.49 RUB

Attribute name:
delivery(country:service:price)

Attribute values:
RU:Standard:12.99 RUB
RU::17.80 RUB,RU:Express:25.99 RUB

Attribute name:
delivery(price)

Attribute values:
6.49 RUB

Attribute name:
delivery

Attribute values:
RU:::6.49 RUB
RU::Standard:0 RUB,RU::Express:13.12 RUB

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>RU</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 RUB</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. AT
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
AT:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
AT:Standard:12.99 EUR
AT::17.80 EUR,AT:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
AT:::6.49 EUR
AT::Standard:0 EUR,AT::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>AT</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. BE
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 EUR
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
BE:6.49 EUR

Attribute name:
delivery(country:service:price)

Attribute values:
BE:Standard:12.99 EUR
BE::17.80 EUR,BE:Express:25.99 EUR

Attribute name:
delivery(price)

Attribute values:
6.49 EUR

Attribute name:
delivery

Attribute values:
BE:::6.49 EUR
BE::Standard:0 EUR,BE::Express:13.12 EUR

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>BE</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 EUR</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. TR
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 TRY
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
TR:6.49 TRY

Attribute name:
delivery(country:service:price)

Attribute values:
TR:Standard:12.99 TRY
TR::17.80 TRY,TR:Express:25.99 TRY

Attribute name:
delivery(price)

Attribute values:
6.49 TRY

Attribute name:
delivery

Attribute values:
TR:::6.49 TRY
TR::Standard:0 TRY,TR::Express:13.12 TRY

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>TR</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 TRY</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. PL
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 PLN
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
PL:6.49 PLN

Attribute name:
delivery(country:service:price)

Attribute values:
PL:Standard:12.99 PLN
PL::17.80 PLN,PL:Express:25.99 PLN

Attribute name:
delivery(price)

Attribute values:
6.49 PLN

Attribute name:
delivery

Attribute values:
PL:::6.49 PLN
PL::Standard:0 PLN,PL::Express:13.12 PLN

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>PL</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 PLN</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. SE
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 SEK
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
SE:6.49 SEK

Attribute name:
delivery(country:service:price)

Attribute values:
SE:Standard:12.99 SEK
SE::17.80 SEK,SE:Express:25.99 SEK

Attribute name:
delivery(price)

Attribute values:
6.49 SEK

Attribute name:
delivery

Attribute values:
SE:::6.49 SEK
SE::Standard:0 SEK,SE::Express:13.12 SEK

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>SE</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 SEK</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. NO
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 NOK
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
NO:6.49 NOK

Attribute name:
delivery(country:service:price)

Attribute values:
NO:Standard:12.99 NOK
NO::17.80 NOK,NO:Express:25.99 NOK

Attribute name:
delivery(price)

Attribute values:
6.49 NOK

Attribute name:
delivery

Attribute values:
NO:::6.49 NOK
NO::Standard:0 NOK,NO::Express:13.12 NOK

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>NO</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 NOK</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. DK
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 DKK
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
DK:6.49 DKK

Attribute name:
delivery(country:service:price)

Attribute values:
DK:Standard:12.99 DKK
DK::17.80 DKK,DK:Express:25.99 DKK

Attribute name:
delivery(price)

Attribute values:
6.49 DKK

Attribute name:
delivery

Attribute values:
DK:::6.49 DKK
DK::Standard:0 DKK,DK::Express:13.12 DKK

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>DK</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 DKK</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. MX
region or postcode or location ID or location group name Only used in Australia, Japan and the US    
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 10.00 MXN
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:price)

Attribute values:
MX:6.49 MXN

Attribute name:
delivery(country:service:price)

Attribute values:
MX:Standard:12.99 MXN
MX::17.80 MXN,MX:Express:25.99 MXN

Attribute name:
delivery(price)

Attribute values:
6.49 MXN

Attribute name:
delivery

Attribute values:
MX:::6.49 MXN
MX::Standard:0 MXN,MX::Express:13.12 MXN

XML The three sub-attributes are country, service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>MX</g:country>
   <g:service>Standard</g:service>
   <g:price>10.00 MXN</g:price>
</g:delivery>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.

This attribute provides the specific delivery estimate for the product. Providing this attribute for an item overrides the global delivery settings that you defined in your Google Merchant Center settings.

This attribute has four sub-attributes:

  • country (optional): The country to which an item will be delivered (as an ISO 3166 country code). The default value for this sub-attribute is your feed's target country.
  • geographical area. There are four sub-attributes supported to specify a geographical area where a delivery rate applies. Only one should be used for each delivery entry.
    • region (optional): The geographical region to which a delivery rate applies, e.g. CA. Currently supported for states in the US and Australia and prefectures in Japan.
    • postcode (optional): The postcode range that a delivery rate applies to, for example in the US, a ZIP code, a ZIP code prefix range using * wildcard, a range of ZIP codes between two ZIP Codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460 or 94*-95*. Currently supported for the US and Australia.
    • location id (optional): The numeric ID of a location that a delivery rate applies to as defined in the AdWords API. Supported location types:
    • US: state and city
    • Australia: state
    • Japan: prefecture
    • For example, for San Francisco: 1014221
    • location group name (optional): In your Merchant Center account, locations may be grouped, and each group assigned a name. These group names may then be included in this sub-attribute. For example, several US states may be grouped to form a location group named "East Coast". Currently supported for the US, Australia and Japan.
  • service (optional): The name of the delivery method.
  • price (required): Fixed delivery price.

You can include this attribute up to 100 times per item to specify delivery costs for individual regions. If you decide to submit it explicitly for each part of the country, ensure that you cover each region or specify whether the item has free delivery.

Note: Remember that you must only provide direct-to-consumer delivery rates, as per our Programme Policies. Rates for other methods, such as deliver-to-shop delivery, are not allowed.

When to include: If you want to specify a delivery cost for this item, or you want to override the default delivery cost specified in the Merchant Center settings. Find out more.

Type Each delivery attribute group can consist of four sub-attributes:
Name Requirement Description Examples
country optional The country to which an item will be delivered (as an ISO 3166 country code). The default value for this attribute is your feed's target country. US

region or postcode or location ID or location group name

Only one should be used for each delivery entry

optional The geographical area to which a delivery rate applies. Each sub-attribute option has specific values that are accepted. CA or 94043 or 1014044 or East Coast
service optional The service class or delivery speed Ground
price required Fixed delivery price (including VAT) 6.49 USD
Note: You can submit multiple values for this attribute.
Text/Tab-delimited

Unlike most other Merchant Center attributes, the format of this attribute depends on the format of the attribute name in the header row of your file.

When submitting the delivery attribute, you’ll tell us which sub-attribute values to expect by the way that you format the attribute name in the header row. The attribute name should consist of the attribute name (in this case, 'delivery') followed by the sub-attributes that you’ll submit in parenthesis, separated by colons. The sub-attribute price is required.

Note: If sub-attributes are not included with the attribute name, we’ll assume that your attribute values include 4 sub-attributes (country, region, service and price).

Submit sub-attribute values that match the sub-attributes specified in the attribute name. The order of the values must match the order in the attribute name. Separate each sub-attribute with a colon and each delivery attribute group with a comma. Do not enclose the values for this attribute within quotation marks. All colons, even for blank values, are required.

Attribute name:
delivery(country:postal code:price)

Attribute values:
US:80302:6.49 USD
US:30*:12.75 USD
US:94002-95460:0 USD, US:900*-901*:15.99 USD

Attribute name:
delivery(country:location id:service:price)

Attribute values:
US:1012873:Ground:12.99 USD
US:1025433:Express:17.80 USD,US:1014212::25.99 USD

Attribute name:
delivery(country:location group name:service:price)

Attribute values:
US:western states::0 USD
US:manhattan and surrounding::22.59 USD,US:close to warehouse:Ground:7.78 USD

Attribute name:
delivery(price)

Attribute values:
6.49 USD

Attribute name:
delivery

Attribute values:
US:::6.49 USD
US:CA:Ground:0 USD,US:MA:Express:13.12 USD

XML (Feeds) The four sub-attributes are country, geographical area (region, postcode, location ID or location group name), service and price. Include each delivery attribute group as a separate attribute.
<g:delivery>
   <g:country>US</g:country>
   <g:region>MA</g:region>
   <g:service>Ground</g:service>
   <g:price>6.49 USD</g:price>
</g:delivery>
Content API v2 (JSON) { &nbsp&nbsp&nbsp"country": "US", &nbsp&nbsp&nbsp"region": "MA", &nbsp&nbsp&nbsp"service": "Ground", &nbsp&nbsp&nbsp"price": { &nbsp&nbsp&nbsp&nbsp&nbsp&nbsp"value": "6.49", &nbsp&nbsp&nbsp&nbsp&nbsp&nbsp"currency": "USD" &nbsp&nbsp&nbsp} }
Content API v2 (XML) <shipping> &nbsp&nbsp&nbsp<country>US</country> &nbsp&nbsp&nbsp<region>MA</region> &nbsp&nbsp&nbsp<service>Ground</service> &nbsp&nbsp&nbsp<price currency="USD">6.49</price> </shipping>

Important:

  • For feeds targeting the US, UK, Germany, Australia, France, Switzerland, the Czech Republic, the Netherlands, Italy, Spain and Japan, it is required to provide delivery costs for every item, either by specifying the global default delivery costs in the Merchant Center settings, or by providing this attribute. If you do not provide delivery costs using one of these methods for each item, your items won’t be shown in Google Shopping results.
  • If country is not included, we assume that the delivery price applies to the target country of the item. If region, postcode, location ID or location group name is not included, the delivery price will apply across the entire country.
delivery weight [shipping_weight] – Weight of the item for delivery

This is the weight of the product used to calculate the delivery cost of the item. If you have specified a delivery method that is dependent on delivery weight, this attribute will be used to calculate the delivery cost of the item automatically. Find out more

When to include: Required if you set up a delivery method in the Merchant Center using a carrier-calculated rate, a table based on weight or a rule based on weight.

Type We only accept the following units of weight: lb, oz, g and kg.
Text/Tab delimited Kg
XML (Feeds) <g:shipping_weight>3 kg</g:shipping_weight>

Important:

  • The weight must include a number and a unit of weight. We accept the following units: lb, oz, g, kg.
delivery length [delivery_length] – Length of the item for delivery

This is the length of the package needed to deliver the product. Find out more

When to include: Always recommended if you use carrier-calculated rates in your delivery methods. This allows us to calculate accurate delivery rates in cases where the dimensional weight of your items is higher than their actual weight.

Type We accept only the following units of length: in, cm
Text/Tab delimited 20 in
XML (Feeds) <g:shipping_length>20 in</g:shipping_length>
Content API v2 (JSON) "shippingLength": {
   "value": "20",
   "unit": "in"
}
Content API v2 (XML) <shipping_length unit="in">20</shipping_length>

Important:

  • The length must include a number and a unit of measurement. We accept the following units: in, cm. The number can be any value from 1 to 1,000.
  • If you include one of the delivery dimension attributes for an item, you need to include them all: 'delivery length', 'delivery width' and 'delivery height'. You must use the same unit of measurement for each of these attributes on a single item.
  • If you don't provide delivery 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 that you provided in 'delivery weight'.
  • Google doesn't automatically calculate additional delivery costs for oversized items. If your package would be considered large or oversized by your carrier, you should either use the 'delivery' attribute to set an item-level delivery cost or use the 'delivery label' attribute with an account-level delivery rule to set the cost.
delivery width [delivery_width] – Width of the item for delivery

This is the width of the package needed to deliver the product. Find out more

When to include: Always recommended if you use carrier-calculated rates in your delivery methods. This allows us to calculate accurate delivery rates in cases where the dimensional weight of your items is higher than their actual weight.

Type We accept only the following units of length: in, cm
Text/Tab delimited 12 in
XML (Feeds) <g:shipping_width>12 in</g:shipping_width>
Content API v2 (JSON) "shippingWidth": {
   "value": "12",
   "unit": "in"
}
Content API v2 (XML) <shipping_width unit="in">12</shipping_width>

Important:

  • The width must include a number and a unit of measurement. We accept the following units: in, cm. The number can be any value from 1 to 1,000.
  • If you include one of the delivery dimension attributes for an item, you need to include them all: 'delivery length', 'delivery width' and 'delivery height'. You must use the same unit of measurement for each of these attributes on a single item.
  • If you don't provide delivery 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 that you provided in 'delivery weight'.
  • Google doesn't automatically calculate additional delivery costs for oversized items. If your package would be considered large or oversized by your carrier, you should either use the 'delivery' attribute to set an item-level delivery cost or use the 'delivery label' attribute with an account-level delivery rule to set the cost.
delivery height [delivery_height] – Height of the item for delivery

This is the height of the package needed to deliver the product. Find out more

When to include: Always recommended if you use carrier-calculated rates in your delivery methods. This allows us to calculate accurate delivery rates in cases where the dimensional weight of your items is higher than their actual weight.

Type We accept only the following units of length: in, cm
Text/Tab delimited 12 in
XML (Feeds) <g:shipping_height>12 in</g:shipping_height>
Content API v2 (JSON) "shippingHeight": {
   "value": "12",
   "unit": "in"
}
Content API v2 (XML) <shipping_height unit="in">12</shipping_height>

Important:

  • The height must include a number and a unit of measurement. We accept the following units: in, cm. The number can be any value from 1 to 1,000.
  • If you include one of the delivery dimension attributes for an item, you need to include them all: 'delivery length', 'delivery width' and 'delivery height'. You must use the same unit of measurement for each of these attributes on a single item.
  • If you don't provide delivery 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 that you provided in 'delivery weight'.
  • Google doesn't automatically calculate additional delivery costs for oversized items. If your package would be considered large or oversized by your carrier, you should either use the 'delivery' attribute to set an item-level delivery cost or use the 'delivery label' attribute with an account-level delivery rule to set the cost.
delivery label [shipping_label]

This attribute can be used to assign labels to specific products using values of your choosing, such as perishable, bulky or promotion. In your Merchant Center account delivery settings, you may then configure different delivery rates for items labelled perishable, bulky and promotion.

When to include: Use for custom grouping of products in your delivery rules.

Type string
Character limit 100
Text/Tab-delimited perishable
XML <g:shipping_label>perishable</g:shipping_label>

Product Combinations

These attributes allow you to submit information about merchant-defined multipacks and merchant-defined bundles

multipack [multipack] – Submit merchant-defined multipacks

Multipacks are packages that include several identical products to create a larger unit of sale, submitted as a single item. Merchant-defined multipacks are custom groups of identical products submitted as a single unit of sale. The ‘multipack’ attribute indicates the number of identical products in a merchant-defined multipack.

When to include: Required if applicable to submit merchant-defined multipacks for all countries except Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey.

Type Integer, greater than 1 (multipacks cannot contain 1 item)
Text/Tab-delimited 6
XML <g:multipack>6</g:multipack>

Important:

  • The price attribute must contain the total price for the multipack.
  • The main image of the multipack must display the base product: The single manufacturer-defined product that is the base item of the multipack (i.e. one unit of the custom multipack).
  • The unique product identifiers of the base product should be submitted according to the Unique Product Identifier Rules.
  • This attribute should NOT be used to indicate the number of items in a manufacturer-defined multipack.
  • When the base product of a merchant-defined multipack is a manufacturer-defined multipack, the attribute should indicate the number of manufacturer-defined multipacks being bundled, and the unique product identifiers for the manufacturer-defined multipack should be provided.
  • Images, descriptions and all other attributes submitted for multipacks must be in alignment with the our feed specifications and the Google Shopping Policies.

Example of a merchant-defined multipack submission:

A custom multipack containing 6 bars of soap: The ‘multipack’ attribute should be 6, the unique product identifiers for a single bar of soap should be provided according to the Unique Product Identifier Rules and we recommend that the description should include "multipack" and include the quantity (6).

is bundle [is_bundle] – Submit merchant-defined bundles

Merchant-defined bundles are custom groupings of different products defined by a merchant and sold together for a single price. A bundle features a main item sold with various accessories or add-ons, such as a camera combined with a bag and a lens. The main item of a bundle is the featured product of those items included in the bundle. Since they are defined by the merchant, these bundles as a whole unit typically do not have unique product identifiers. When submitting a merchant-defined bundle, use the 'is bundle' attribute and provide the unique product identifiers corresponding to the main item in the bundle. Using the 'is bundle' attribute for your merchant-defined bundles will allow you to distinguish them from multipacks and product listings that contain a main item only.

When to include: Required to submit merchant-defined bundles for all countries except Austria, Belgium, Canada, Denmark, India, Mexico, Norway, Poland, Russia, Sweden and Turkey.

Type Boolean: TRUE or FALSE
Text/Tab-delimited TRUE
XML <g:is_bundle>TRUE</g:is_bundle>

Important:

  • When the attribute is not specified, the default value is FALSE.
  • Only use 'is bundle' for bundles that clearly have a main item. For items that do not have a main item, such as a gift basket containing cheese and crackers, do not use the 'is bundle' attribute.
  • The main item of a bundle is the featured product of those items included in the bundle. The additional items should be accessories or add-ons that complement the main item. Examples:
    • For a doll sold with a set of clothes that aren’t packed with the doll, the doll is the main item and the clothes complement it.
    • For a video game console sold with three video games, the video game console is the main item.
  • Mobile phones submitted with a contract must use this attribute.
  • All attributes in your offer should describe the bundle, with the exceptions of 'google product category', 'product type', 'item group ID', variant attributes and the unique product identifiers, all of which should be based on the main item in the bundle.
  • Provide the unique product identifiers for the main item in the bundle, even if your merchant-defined bundle happens to have its own merchant-assigned GTIN or other identifier.
  • Manufacturer-defined bundles have their own unique product identifiers, assigned by the manufacturer, that describe the entire bundle. For such bundles, submit using the unique product identifier that was assigned by the manufacturer describing the entire bundle and don’t provide the ‘is bundle’ attribute.

Other attributes for your bundle:

  • The title and description describe the entire bundle. The image and price must be for the entire bundle.
  • If any item in the bundle is not new, the condition of the entire bundle is the condition of that item. For example, if your bundle is a used camera with new lenses, the condition of the bundle is ‘used’. If a bundle contains both refurbished and used items, the condition of the bundle is 'used'.
  • The unique product identifiers ('brand', 'mpn', 'gtin', 'identifier_exists'), 'product type', 'google product category', 'item group ID' and other product variant attributes must be submitted based on the main item in the bundle.
  • If any item in the bundle is considered adult, you must submit the 'adult' attribute for the entire bundle.

Example of a merchant-defined bundle submission:

A custom bundle containing a phone, a case and a replacement battery would have a title and description that describe the entire grouping. The image is a picture that contains all three items, and the price is for the entire bundle. All three items are new, so the condition of the bundle is 'new'. The main item is the phone, so the 'google product category' is 'Electronics > Communications > Telephony > Mobile Phones' and the 'brand' and 'gtin' are for the phone. 'is bundle' is set to TRUE.

Adult Products

Google cares about the family status of the product listings that you submit in order to make sure that appropriate content is shown to an appropriate audience. You should use the ‘adult’ attribute to indicate that individual items will be considered “adult”.

For more information on our “adult” status, refer to our Adult-orientated content policy.

adult [adult]

The adult status assigned to your product listings through the ‘adult’ attribute affects where product listings can show. For example, "adult" product listings aren't allowed to be shown in certain countries or to a certain audience.

If your website generally targets an adult audience and contains adult-orientated content with or without nudity, you are responsible for labelling your site as intended for an adult audience by ticking the tickbox “This site contains adult products as defined by our policy” in the “General settings” section of the Merchant Center account. Where you fail to do so, Merchant Center accounts containing product listings considered as "adult" will be suspended.

If your website doesn’t generally target an adult audience but you are promoting some product listings containing adult-orientated content with or without nudity, such product listings should be submitted with an ‘adult’ attribute value set to TRUE. This will indicate that the correlating product listing contains “adult” content as defined by our policy. Where you fail to do so, your account will be considered as “adult” and disapproved, and your items will not appear on Google Shopping.

When to include: If you are submitting items that are considered “adult” and would like to label them at the item level for all target countries.

Type Boolean: TRUE or FALSE
Text/Tab-delimited TRUE
XML (Feeds) <g:adult>TRUE</g:adult>

Important:

  • This attribute is a supplement to the option in the General settings tab of Merchant Center to select that your account includes data feeds which may contain product listing that will be considered "adult". By using the ‘adult’ attribute, you are acknowledging that individual items, rather than your entire website, may be “adult”.
  • You need to ensure that when accessed from a family-safe product listing, the landing page is completely free from adult content.
  • If the tickbox “This site contains adult products as defined by our policy” in the “General settings” section of the Merchant Center account is not ticked and the value of the ‘adult’ attribute is left blank or the attribute is not provided, we will assume that the value of adult is FALSE.

AdWords Attributes

These attributes help you to organize your AdWords campaigns and track the traffic to your website.

adwords redirect [adwords_redirect]

Allows advertisers to specify a separate URL that can be used to track traffic coming from Google Shopping. If this attribute is provided, you must make sure that the URL provided through 'adwords redirect' will redirect to the same website as given in the ‘link’ or ‘mobile link’ attribute.

This attribute can be used in Shopping campaigns. Learn more about the 'adwords redirect' attribute.

Type URL
Character limit 2,000
Text/Tab-delimited http://www.merchant.com/product.html
XML <g:adwords_redirect>
http://www.merchant.com/product.html
</g:adwords_redirect>

Custom Label Attributes for Shopping Campaigns

Shopping campaigns are a better way to use Product Listing Ads and promote your products online using retail-centric tools to manage and optimise your campaigns. With Shopping campaigns, you create product groups based on the attributes for your product data, and then set bids on those product groups.

In a Shopping campaign, you subdivide your products based on existing data from the category, brand, item ID, condition, product type and custom label attributes. You can use custom labels if you want to subdivide the products in your campaign using values of your choice. For example, you can use custom labels to indicate that products are seasonal, on clearance, bestsellers, etc. These values can then be selected to use for monitoring, reporting and bidding in your Shopping campaign. Learn more about Shopping campaigns.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute. You should assign a specific definition for each of the five custom labels and specify the possible values for each. You can then use these custom labels consistently across the products in your Merchant Center account, assigning appropriate values to each product according to your definition. Each of the five custom labels can only have one value per product.

As custom labels are meant to allow the grouping of items, only 1,000 unique values are supported for each custom label attribute across the items in your account. Products with a custom label submitted after the limit was exceeded won’t be included in product groups using this custom label. To correct the issue, update your product data to reduce the number of unique values for the custom label to less than 1,000.

Example of custom labels

Step 1: Assign definitions and possible values to custom labels

Custom label Your definition Your choice of possible values
custom label 0 Season Winter, Spring, Summer, Autumn
custom label 1 SellingRate BestSeller, LowSeller
custom label 2 Clearance Clearance
Custom label 3 Margin LowMargin, HighMargin
custom label 4 ReleaseYear 1900 to 2100

Note: Custom label definitions are for your reference only. The definitions aren’t entered in your AdWords or Merchant Center accounts.

Step 2: Assign appropriate values to each product

Item ID custom label 0 custom label 1 custom label 2 custom label 3 custom label 4
item #1 Winter BestSeller LowMargin
item #2 Summer HighMargin 2013
item #3 Clearance 2012

Every custom label can have just one value per product. In addition, it's not necessary for an item to have a value for one or more custom labels. For example, some of your clothing items may not be considered seasonal, so you wouldn’t assign a value to those items for “custom label 0” in the example above.

custom label 0 [custom_label_0]

This attribute can be used to group the items in a Shopping campaign by values of your choosing, such as seasonal or clearance.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute.

When to include: Use for the custom grouping of items in a Shopping campaign.

Type string
Character limit 100
Text/Tab-delimited seasonal
XML <g:custom_label_0>seasonal</g:custom_label_0>
custom label 1 [custom_label_1]

This attribute can be used to group the items in a Shopping campaign by values of your choosing, such as seasonal or clearance.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute.

When to include: Use for the custom grouping of items in a Shopping campaign.

Type string
Character limit 100
Text/Tab-delimited clearance
XML <g:custom_label_1>clearance</g:custom_label_1>
custom label 2 [custom_label_2]

This attribute can be used to group the items in a Shopping campaign by values of your choosing, such as seasonal or clearance.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute.

When to include: Use for the custom grouping of items in a Shopping campaign.

Type string
Character limit 100
Text/Tab-delimited holiday
XML <g:custom_label_2>holiday</g:custom_label_2>
custom label 3 [custom_label_3]

This attribute can be used to group the items in a Shopping campaign by values of your choosing, such as seasonal or clearance.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute.

When to include: Use for the custom grouping of items in a Shopping campaign.

Type string
Character limit 100
Text/Tab-delimited sale
XML <g:custom_label_3>sale</g:custom_label_3>
custom label 4 [custom_label_4]

This attribute can be used to group the items in a Shopping campaign by values of your choosing, such as seasonal or clearance.

You can create up to five custom labels, numbered 0 to 4, for each item in your feed. You may submit one value per item for each custom label attribute.

When to include: Use for the custom grouping of items in a Shopping campaign.

Type string
Character limit 100
Text/Tab-delimited best seller
XML <g:custom_label_4>best seller</g:custom_label_4>

Additional Attributes

The two attributes below allow you to control the destination of your items and the period during which your items are valid.

excluded destination [excluded_destination] – Excluded destinations of your items

The ‘excluded destination’ attribute prevents an item from appearing in certain destinations even though it appears in your product data. This attribute might be useful to you if you have products that you can’t remove from your product data, but you don’t want them to appear to the public. You could also use this attribute if you wanted to include your products in certain campaign types but not others. For example, you want to allow your products to appear in a dynamic re-marketing campaign, but not on Google Shopping.

When to include: You want to exclude the item from a destination.

Format Predefined values accepted:
  • Shopping
Text/Tab-delimited Shopping
XML <g:excluded_destination>Shopping</g:excluded_destination>
expiry date [expiration_date] – Date that an item will expire

This is the date when an item listing will expire. If you do not provide this attribute, items will expire and no longer appear in Google Shopping results after 30 days. You cannot use this attribute to extend the expiry period to longer than 30 days.

When to include: If you would like an item to expire earlier than 30 days from the upload date of the feed.

Type ISO 8601 format: YYYY-MM-DD. Note that times are in GMT
Character limit 10
Text/Tab-delimited 2004-08-19
XML <g:expiry_date>2004-08-19</g:expiry_date>

Unit Prices (EU Countries and Switzerland Only)

These attributes allow you to submit the unit pricing for your applicable products in feeds targeting European Union countries and Switzerland.

Please note that you should not submit both unit prices and energy labels for an item.

Unit Prices (US Only)

These attributes allow you to submit pricing for products that rely on unit pricing. You might need to use these attributes to clarify your prices for the following reasons:

  • If your products are typically sold by a quantity of units
  • If your products are required to show the price per unit to comply with regulations.

If your products don't fit one of these categories, you don't need to use these attributes.

unit-pricing measure [unit_pricing_measure]

The 'unit-pricing measure' attribute allows you to specify unit-pricing information for an item. This attribute defines the measure and dimension of an item, e.g. 135 ml or 55 g. The unit price refers to the volume, weight, area or length of the product without any packaging or the net drained weight of the product (in the case of food).

Unit-pricing attributes are recommended only for specific products that require unit pricing to comply with local, regional or national laws applicable to the country that your product listings are targeting. For example, if your product listings are targeting any of the EU Member States or Switzerland, please consider the legal requirements on this matter defined in the national implementation acts of the EU Directive 98/6/EC and any other applicable local law.

We may not display this product information on every device, including mobile phones and/or tablets. Please consider the legal requirements applicable to the country that your product listings are targeting before sending your product data to Google Shopping.

When to include: Recommended if applicable for items in feeds targeting an EU country or Switzerland. It is also recommended that you submit the 'unit-pricing base measure' attribute in conjunction with 'unit-pricing measure'.

Type Numerical value + unit. Weight (mg, g, kg), volume (ml, cl, l, cbm), length (cm, m) and area (sqm) are supported.
Text/Tab-delimited 225 g
XML <g:unit_pricing_measure>225 g</g:unit_pricing_measure>

Important:

  • The price attribute or the sales price attribute (if the sale is active) will be used in order to calculate the unit price of this item (e.g. if the price is GBP 3, the 'unit pricing measure' is 150 ml and the 'unit pricing base measure' is 100 ml, the unit price would be GBP 2/100 ml).
  • The unit price will be rounded to the nearest amount allowed in the local currency and values exactly halfway between two values will be rounded up (e.g. GBP 0.005 will be rounded up to GBP 0.01)
  • The numerical value has to be a positive number. Examples: 1.5 kg, 150 ml, 3 sq m
unit-pricing measure [unit_pricing_measure]

The 'unit pricing measure' attribute defines the measure and dimension of an item, e.g. 135 ml or 55 g. The unit pricing measure refers to the volume, weight, area, length or count of the product without any packaging or the net drained weight of the product (in the case of food).

When to include: Recommended if you need to use unit pricing to show the price for your item. It is also recommended that you submit the 'unit-pricing base measure' attribute in conjunction with 'unit-pricing measure'. Unit pricing attributes are strongly recommended for the following product categories:

  • Hardware > Building Materials > Wall & Ceiling Tile
  • Hardware > Building Materials > Flooring & Carpet
  • Hardware > Building Consumables > Masonry Consumables > Bricks & Concrete Blocks
  • Hardware > Building Materials > Lumber & Sheet Stock
  • Hardware > Building Materials > Roofing > Roofing Shingles & Tiles
  • Hardware > Hardware Accessories > Hardware Fasteners
  • Office Supplies > Shipping Supplies > Moving & Shipping Boxes
  • Office Supplies > General Office Supplies > Paper Products > Business Cards
  • Office Supplies > General Office Supplies > Paper Products > Checks
  • Food, Beverages & Tobacco > Beverages
  • Food, Beverages & Tobacco > Food Items
Type Numerical value + unit.

Accepted units are:
  • Weight: oz, lb, mg, g, kg
  • Volume: fl oz, pt, qt, gal, ml, cl, l, cbm
  • Length: in, ft, yd, cm, m
  • Area: sq ft, sq m
  • Per unit: ct
Text/Tab-delimited 225 g
XML <g:unit_pricing_measure>225 g</g:unit_pricing_measure>
Content API v2 (JSON) "unitPricingMeasure": {
   "value": 225,
   "unit": "oz"
}
Content API v2 (XML) <unit_pricing_measure unit="oz">225
</unit_pricing_measure>

Important:

  • You must use the 'price' or 'sale price' attribute to provide the total price for the amount specified in the 'unit pricing measure' attribute. The price that you provide will be used to calculate the unit price of the item (e.g. if the price is GBP 3, the 'unit pricing measure' is 150 ml and the 'unit pricing base measure’ is 100 ml, the unit price would be GBP 2/100 ml).
  • The unit price will be rounded to the nearest amount allowed in the local currency and values exactly halfway between two values will be rounded up (e.g. GBP 0.005 will be rounded up to GBP 0.01).
  • The numerical value has to be a positive number. Examples: 1.5 kg, 150 ml, 3 sq m
unit-pricing base measure [unit_pricing_base_measure]

The 'unit-pricing base measure' attribute specifies your preference of the denominator of the unit price (e.g. 100 ml). You should only submit this attribute if you also submit 'unit-pricing measure'.

You should only submit unit-pricing attributes for specific products that require unit pricing to comply with local, regional or national laws applicable to the country that your product listings are targeting. For example, if your product listings are targeting any of the EU Member States or Switzerland, please consider the legal requirements on this matter defined in the national implementation acts of the EU Directive 98/6/EC and any other applicable local law.

We may not display this product information on every device, including mobile phones and/or tablets. Please consider the legal requirements applicable to the country that your product listings are targeting before sending your product data to Google Shopping.

When to include: Recommended if applicable for items in feeds targeting an EU country or Switzerland. You should only submit this attribute if you also submit 'unit-pricing measure', but it is not required to show unit prices.

Type Integer value + unit. Weight (mg, g, kg), volume (ml, cl, l, cbm), length (cm, m) and area (sqm) are supported.
Text/Tab-delimited 100 g
XML (Feeds) <g:unit_pricing_base_measure>100 g</g:unit_pricing_base_measure>

Important:

  • The integer value has to be 1, 10 or 100. Additionally, 75 cl, 50 kg and 1,000 kg are accepted.
  • 'Unit-pricing measure' and 'unit-pricing base measure' have to use the same type of measurement (e.g. you cannot use weight units for one and volume units for the other one).
  • A unit without an integer value is not accepted.
  • Google might show a different base measure in order to make the unit prices on a page more comparable.
unit-pricing base measure [unit_pricing_base_measure]

The 'unit pricing base measure' attribute specifies your preference of the denominator of the unit price (e.g. 100 ml). You should only submit this attribute if you also submit 'unit-pricing measure'.

When to include: Recommended if you also submit the 'unit pricing measure' attribute.

Type Integer value + unit.

Accepted units are:
  • Weight: oz, lb, mg, g, kg
  • Volume: fl oz, pt, qt, gal, ml, cl, l, cbm
  • Length: in, ft, yd, cm, m
  • Area: sq ft, sq m
  • Per unit: ct
Text/Tab-delimited 100 g
XML (Feeds) <g:unit_pricing_base_measure>100 g</g:unit_pricing_base_measure>
Content API v2 (JSON) "unitPricingBaseMeasure"": {
   "value": "100",
   "unit": "oz"
}
Content API v2 (XML) <unit_pricing_base_measure unit="oz">100
</unit_pricing_base_measure>

Important:

  • The integer value has to be 1, 10 or 100. Additionally, 75 cl, 750 ml, 50 kg and 1,000 kg are accepted.
  • 'Unit-pricing measure' and 'unit-pricing base measure' have to use the same type of measurement (e.g. you cannot use weight units for one and volume units for the other one).
  • A unit without an integer value is not accepted.
  • We might show a different base measure in your ads to make the unit prices more comparable for all ads shown on the same page.

Energy Labels (EU Countries and Switzerland Only)

This attribute allows you to submit the energy label for your applicable products in feeds targeting European Union countries and Switzerland.

Please note that you should not submit both unit prices and energy labels for an item.

energy efficiency class [energy_efficiency_class]

The 'energy efficiency class' attribute allows you to specify the energy efficiency class for certain product categories as defined in EU Directive 2010/30/EU.

You should only submit the energy efficiency class attribute for specific products that require it to comply with local, regional or national laws applicable to the country that your product listings are targeting. For example, if your product listings target any of the EU Member States or Switzerland, please consider the legal requirements on this matter defined in the national implementation acts of the EU Directive 2010/30/EU and any other applicable local law.

We may not display this product information on every device, including mobile phones and/or tablets. Please consider the legal requirements applicable to the country that your product listings are targeting before sending your product data to Google Shopping.

When to include: Recommended if applicable for items in feeds targeting an EU country or Switzerland.

Type Enumeration: G, F, E, D, C, B, A, A+, A++, A+++
Text/Tab-delimited A+
XML <g:energy_efficiency_class>A+</g:energy_efficiency_class>

Important:

  • Products that might require this attribute include but are not limited to: Refrigerators, freezers, combined washer-driers, wine-storage appliances, washing machines, tumble dryers, dishwashers, cookers, water heaters and hot water storage appliances, air conditioning units, electrical lamps, lighting units and televisions.
  • For conventional water heaters, solar water heaters, heat pump water heaters and packages of water heater and solar device, the water heating energy efficiency class should be provided.
  • For reversible air conditioning units, the energy efficiency class for heating (average season) should be provided.

Loyalty Points (Japan Only)

The attribute below only applies to feeds which target Japan. It lets you specify how many and what type of loyalty points the customer receives when buying a product.

loyalty points [loyalty_points] – Loyalty points that users receive after purchasing the item

We only support loyalty points that have specific monetary value. For example, we don’t support mileage, loyalty points that are only exchangeable with goods, etc. Loyalty points have to be issued by you. For example, points associated with credit cards and electronic money are not supported. We do support loyalty programme platforms that support cross-industry points, as long as you issue the points.

When to include: Recommended for items targeting Japan, for which the user gets loyalty points.

This attribute has three parts:

  • name (optional): Name of loyalty points programme. It is recommended to limit the name to 12 full-width characters or 24 roman characters.
  • points value (required): The retailer’s loyalty points in absolute value.
  • ratio (optional): The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.
Type Each loyalty point programme group consists of three sub-attributes:
Name Requirement Description Examples
Name (text) Optional Name of loyalty points programme. It is recommended that you limit the name to 12 full-width characters or 24 Roman characters. Programme A
Points value (number) Required The retailer’s loyalty points in absolute value. 100
Ratio (number) Optional The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0. 1.5
Text/Tab-delimited Separate each sub-attribute with a colon. Do not enclose sub-attribute values within quotations. All colons, even for blank values, are required, i.e. three colons are required. You should include attributes in order of priority.
Programme A:100:1.0 This means 100 points, where 1 point equals 1.0 currency unit.
Programme B:100:0.5 This means 100 points, where 1 point equals 0.5 currency units.
Programme C:100: Leaving 'ratio' blank, which defaults to 1.0
:100: Simplest form
XML The three sub-attributes are name, points and ratio. Include each loyalty points attribute group as a separate attribute.
<g:loyalty_points>
   <g:name>Programme A</g:name>
   <g:points_value>100</g:points_value>
   <g:ratio>1.0</g:ratio>
</g:loyalty_points>

Multiple Installments (Brazil Only)

The attribute below only applies to feeds which target Brazil. It lets you specify an additional option for users to pay in multiple installments.

instalment [installment] – Number and amount of instalments to pay for an item.

If you offer multiple options to pay in instalments, you can choose which one to include. The option needs to be visible on the landing page.

When to include: For items submitted to Brazil that can also be paid in multiple instalments.

This attribute has two parts:

  • Months (required): The number of instalments that the buyer has to pay.
  • Amount (required): The amount that the buyer has to pay per month. Include the currency.
Type Each instalment group consists of two sub-attributes:
Name Requirement Description Examples
Months (number) Required The number of instalments that the buyer has to pay. 6
Amount (number) Required The amount that the buyer has to pay per month. Include the currency. 50 BRL
Text/Tab-delimited Separate each sub-attribute with a colon. Do not enclose sub-attribute values within quotations.
6:50 BRL This means payments for 6 months at 50 BRL per month.
XML The two sub-attributes are months and amount. Include each instalments attribute group as a separate attribute.
<g:instalment>
   <g:months>6</g:months>
   <g:amount>50 BRL</g:amount>
</g:instalment>

Important:

  • The instalment option that you include must not require the possession of a loyalty card.

Merchant Promotions Attribute

For retailers using Merchant Promotions, the 'promotion ID' attribute is used in both your products feed and your promotions feed to match products to promotions across the two feeds.

Learn more about Merchant Promotions, including country availability and data feed requirements.

promotion ID [promotion_id]

The unique ID of a promotion. For online promotions that apply to specific products, the 'promotion id' in your promotions feed should match this attribute in your products feed so Google knows which products belong to this promotion.

Important:

  • The 'promotion id' is case sensitive. If you're mapping a specific promotion to a set of products in your products feed, the 'promotion id' you provide must match in both feeds.
  • The 'promotion id' should not contain spaces or symbols (e.g., %, !, etc.).
  • To add multiple 'promotion id' values to an item, submit the values separated by commas in the 'promotion id' column in your products feed.
Was this article helpful?