Source : Merchant Center


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 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 apparel), 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 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.
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 color, 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 in either 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 for 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").

Basic Product Information

The following attributes contain basic information about your items.
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. If you have multiple feeds, ids of items within different feeds must still be unique. You can use any sequence of letters and digits for the item id.
When to include: Required for all items.
Type Alphanumeric characters
Text/Tab delimited tddy123uk
XML <g:id>tddy123uk</g:id>
Important:
  • Once an item is submitted, the id must not change when you update your data feed or be used for a different product at a later point in time.
  • For Switzerland only: If your website is in multiple languages, submit one feed per language. You may re-use 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 you include characteristics such as color or brand in the title which differentiates the item from other products.
When to include: Required for all items.
Type Text. Should not be longer than 70 characters
Text/Tab delimited Mens Pique Polo Shirt
XML <title>Mens Pique Polo Shirt</title>
Important:
  • Follow our Editorial guidelines closely. For example, do not include any promotional text such as "Free shipping", and do not use BLOCK CAPITALS.
  • For variant products, you are required to include the common title of the variant items. For example if “Mens Pique Polo Shirt” is available in red and blue colors, you can have one of the following titles:
    • Mens Pique Polo Shirt (Can be used for both variants)
    • Mens Pique Polo Shirt - Red (For the red shirt)
    • Mens Pique Polo Shirt - Blue (For the blue shirt)
  • For mobile devices bundled with service contracts, you may include a price value of 0.00 USD for your items. The items must be submitted with the ‘google product taxonomy’ value of ‘Electronics > Communications > Telephony > Mobile Phones’ for phones or 'Electronics > Computers > Tablet Computers' for tablets and include the phrase “with contract” (or equivalent language) in the ‘title’.
  • For mobile phones or tablets with payments plans in the US, submit the price of the downpayment as your ‘price’. The ‘title’ must include the phrase “with payment plan” (or equivalent language). For feeds targeting Brazil, please use the ‘installment’ attribute to submit mobile devices or tablets with payment plans. Phones or tablets with payment plans are not allowed in other target countries.
description [description] - Description of the item
Include only 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 for finding your item.
We recommend that you submit around 500 to 1,000 characters, but you can submit up to 10,000 characters. Descriptions should follow standard grammar rules and end with a punctuation mark.
When to include: Required for all items.
Type Text
Text/Tab delimited Solid red, queen-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, queen-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:
  • Make sure to follow our Editorial guidelines closely. For example, do not include any promotional text such as "Free shipping", 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 store or other websites
    • Billing, payment, or sales information
    • References to internal categorization systems, e.g. "Toys & Games > Toys > Baby Dolls"
    • Comparisons to other products beyond the item 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 one value, taken from the product taxonomy tree. If your items fall into multiple categories, include only one category which is the most relevant.
Any category from Google’s product taxonomy must include the full path. For example, 'Apparel & Accessories > Clothing > Jeans' is an acceptable value, but 'Jeans' is not.
When to include: For all target countries except Canada, India, and Russia, ‘google product category’ is required for all items that fall within the 'Apparel & Accessories', 'Media', and 'Software' categories. If your products do not fall into one of those categories - or if your feed targets Canada, India, or Russia - this attribute is recommended but not required.
Type Predefined values from Google's product taxonomy
Text/Tab delimited Apparel & Accessories > Clothing > Dresses
XML <g:google_product_category>Apparel &amp; Accessories &gt; Clothing &gt; Dresses</g:google_product_category>
Additional category requirements: For items that fall into the categories listed below, the value 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 'Apparel & Accessories' or ‘Media’, for these items.
  • 'Apparel & Accessories > Clothing'
  • 'Apparel & Accessories > Shoes'
  • 'Apparel & Accessories > Clothing Accessories > Sunglasses'
  • 'Apparel & Accessories > Handbags, Wallets & Cases > Handbags'
  • 'Apparel & Accessories > Jewelry > Watches'
  • 'Media > Books'
  • 'Media > DVDs & Movies'
  • 'Media > Music'
  • Software > Video Game Software' (Note: this category includes all computer games)
Category for bundles: Provide the most appropriate categorization 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’ is an appropriate category to submit for the bundled item.
Category for mobile devices or tables with a price of 0.00 USD: For mobile devices bundled with service contracts, you may include a price value of 0.00 USD for your items. The items must be submitted with the ‘google product taxonomy’ value of ‘Electronics > Communications > Telephony > Mobile Phones’ for phones or 'Electronics > Computers > Tablet Computers' for tablets and include the phrase “with contact” (or equivalent language) in the ‘title’.
Examples of ‘google product category’ submissions:
Leggings fall under the 'Apparel & Accessories > Clothing' category specified above. When submitting leggings:
  • Acceptable categories:
    • 'Apparel & Accessories > Clothing'
    • 'Apparel & Accessories > Clothing' > Pants'
    • 'Apparel & Accessories > Clothing' > Pants > Leggings'
  • Invalid categories
    • 'Apparel & Accessories'
    • Failing to provide any 'google product category'
Rings do not fall under the specific categories listed above. When submitting rings:
  • Acceptable categories:
    • 'Apparel & Accessories'
    • 'Apparel & Accessories > Jewelry
    • 'Apparel & Accessories'> Jewelry > 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 your items from the full Google product taxonomy.
product type [product_type] - Your category of the item
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. Any separator such as > or / may be used.
When to include: Strongly recommended for all items if you have a categorization 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.
Text/Tab delimited Home & Garden > Kitchen & Dining > Appliances > Refrigerators
XML <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 exact item 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 directly sent to the URL specified in the 'link' attribute
When to include: Required for all items.
Type URL (this must include the http:// portion)
Text/Tab delimited http://www.example.com/asp/sp.asp?cat=12&id=1030
XML <link>http://www.example.com/asp/sp.asp?cat=12&amp;id=1030</link>
Important:
  • Read our policies carefully. All your URLs must link directly to webpages about your products without pop ups. We don't allow landing pages requiring sign ups, passwords, or direct links to files/email addresses.
  • If you're performing maintenance on your site that affects your landing pages, you're required to remove your items from Google Shopping during that time.
  • If multiple products are on the same page, it has to be straightforward for the user to find the right product. We recommend only one product per page.
  • For variations of the same product, we recommend you submit URLs that pre-select the variant which the user clicked on in Google Shopping.
  • The URL must not redirect or forward to a location external to your site.
  • The URL must start with 'http://' or 'https://' and use the domain name you verified in Google Webmaster Tools and in the Settings of your Merchant Center account.
  • Any symbols used must be replaced by URL encoded entities (e.g. comma = %2C).
image link [image_link] - URL of an image of the item
This is the URL of an associated image for a product.
If you have multiple different 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, full-size image you have for the product, up to 4MB file size.
  • We recommend images at least 800 pixels in height and width.
  • Do not scale up images or submit thumbnails.
  • For apparel products we require images of at least 250 x 250 pixels.
When to include: Required for all items.
Type URL. (Must start with 'http://' or 'https://'.)
Text/Tab delimited http://www.example.com/image1.jpg
XML <g:image_link>http://www.example.com/image1.jpg</g:image_link>
Important:
  • If you have no image of the item, you cannot submit the item.
  • For products that fall under “Apparel & Accessories” and all corresponding sub-categories in feeds targeting the US, UK, DE, FR, and JP: If you are submitting product variants that differ in ‘‘color’, or ‘pattern’, or ‘material’, we require you to submit specific images corresponding to each of these variants. If you do not have the correct image for the variation of the product, you may not submit that variant. We recommend specific images for ‘size’ variants too. However, if these are not available you may submit the same image URL for items that differ in ‘size’.
  • 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 display the product. Do not submit a placeholder such as "No image", logo of the brand or logo of your store.
  • Images of products must not contain logos or other promotions within the image.
  • The main image of a multipack must display a single unit of the product.
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).
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.)
Text/Tab delimited http://www.example.com/image1.jpg
XML <g:additional_image_link>http://www.example.com/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 restored to working order. This includes, for example, remanufactured printer cartridges.
  • 'used': If the two previous values don't apply. For example, if the product has been used before 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 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 remove all your items from Google Shopping. Please see our policies for more details.
availability [availability] - Availability status of the item
The availability attribute only has four accepted values:
  • 'in stock': Include this value if you are certain that it will ship (or be in-transit to the customer) in 3 business days or less. For example, if you have the item available in your warehouse.
  • 'available for order': Include this value if it will take 4 or more business days to ship it to the customer. For example, if you don’t have it in your warehouse at the moment, but are sure that it will arrive in the next few days. For unreleased products, use the value 'preorder'
  • 'out of stock': You’re currently not accepting orders for this product. (Important tip: When your products are out of stock on your website, don't remove them from your data feed. Provide this value instead).
  • 'preorder': You are taking orders for this product, but it’s not yet been released.
When to include: Required for all items.
Type Four predefined values accepted:
  • 'in stock'
  • 'available for order'
  • 'out of stock'
  • 'preorder'
Text/Tab delimited in stock
XML <g:availability>in stock</g:availability>
Important:
  • You need to clearly indicate the availability of an item on the item's landing page by either explicitly noting the status (such that it's clear which of the above values describe the availability of the item), or mention how many days it takes until the item ships.
  • Items that are no longer sold have to be removed from the feed entirely.
  • If you are submitting the attribute names in English, you must provide the attribute values in English as well.
price [price] - Price of the item
The price of the item has to be the most prominent price 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 USD
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.
  • Make sure to read our policies in detail. Only items with fixed prices are allowed in Google Shopping. Items with variable prices, such as auctions, and prices that require a membership in a club are not allowed.
  • For items sold in bulk quantities, the price for the lowest purchasable number of items must be provided (not the per unit price) and the same price has to be straightforward to find on the landing page.
  • For products on sale, we recommend including the 'sale price' attribute and submit 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 USD for your items. Items with zero prices may not appear in the search results (Note: The only exception is mobile devices bundled with service plans as detailed below).
  • For mobile devices bundled with service contracts, you may include a price value of 0.00 USD for your items. 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 “with contract” (or equivalent language) in the ‘title’.
  • For mobile phones or tablets with payments plans in the US, submit the price of the downpayment as your ‘price’. The ‘title’ must include the phrase “with payment plan” (or equivalent language). For feeds targeting Brazil, please use the ‘installment’ attribute to submit mobile devices or tablets with payment plans. Phones or tablets with payment plans are not allowed in other target countries.
Please note that you can use unit pricing and 'installment' 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 USD
XML <g:sale_price>15.00 USD</g:sale_price>
Important:
  • You must still include the 'price' attribute in your feed, which must reflect the non-sale price you have previously sold the item for.
  • The price must include a currency.
  • Submitted sale prices must exactly match the price displayed on your website. Both prices must be displayed on the landing page (the regular price and the sale price), but the sale price must be most prominent.
  • You must not include a price value of 0.00 USD for your items. Items with zero prices may not appear in the search results.
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 timezone for the sale. The end date should be in the same format.
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>

Unique Product Identifiers

Unique product identifiers are product codes or other identifying values associated with an individual product:
  • Global Trade Item Numbers (GTINs) submitted through the ‘gtin’ attribute. GTINs include UPC, EAN (in Europe), JAN (in Japan), and ISBN;
  • Manufacturer Part Number (MPN) submitted through the 'mpn' attribute; and
  • The manufacturer's brand name in the 'brand' attribute.

Custom goods are one-of-a-kind items for which no unique product identifiers exist, like vintage goods, collectibles, art, perishables, books published before 1970, and other special items.
Learn more about unique product identifiers.

Unique Product Identifier Rules

  • Apparel categories: 'brand' is required. Additionally, for the categories listed below, you must submit at least 1 out of 'gtin' or 'mpn’:
    • 'Apparel & Accessories > Shoes'
    • 'Apparel & Accessories > Clothing Accesories > Sunglasses'
    • 'Apparel & Accessories > Handbags, Wallets & Cases > Handbags'
    • 'Apparel & Accessories > Jewelry > Watches'
  • Media and software categories: 'gtin' is required
  • All other categories: at least 2 of the following 3 identifiers are required: ‘brand’, ‘gtin’, and ‘mpn’.
  • Exception: in categories where unique product identifiers are required but no such identifier exists for an item (e.g. custom goods), submit 'identifier exists' with a value of FALSE.
If you don't provide the required unique product identifiers, your items may be removed from Google Shopping. For all of your items, we recommend submitting all three attributes (‘brand’, ‘mpn’, and ‘gtin’) where available.
brand [brand] - Brand of the item
When to include: Required according to the Unique Product Identifier Rules for all target countries except for Canada, India, and Russia. This attribute is recommended for Canada, India, and Russia.
Type Text
Text/Tab delimited Acme
XML <g:brand>Acme</g:brand>
Important:
  • You must not provide your store name as the brand unless you manufacture the product.
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): 12-digit number such as 3234567890126
  • EAN (in Europe): 13-digit number such as 3001234567892
  • JAN (in Japan): 8 or 13-digit number such as 49123456 or 4901234567894
  • ISBN (for books): 10 or 13-digit number such as 0451524233. If you have both, only include 13-digit number.
When to include: Required according to the Unique Product Identifier Rules for all target countries except for Canada, India, and Russia. This attribute is recommended for Canada, India, Russia.
Type 8-, 12-, or 13-digit number (UPC, EAN, JAN, or ISBN)
Text/Tab delimited 3234567890126
XML <g:gtin>3234567890126</g:gtin>
mpn [mpn] - Manufacturer Part Number (MPN) of the item
A Manufacturer Part Number is used to reference and identify a product using a manufacturer specific naming other than GTIN.
When to include: Required according to the Unique Product Identifier Rules for all target countries except for Canada, India, and Russia. This attribute is recommended for Canada, India, and Russia.
Type Alphanumeric characters
Text/Tab delimited GO12345OOGLE
XML <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 typically be specific to a single unique product. For example, different colors of a product should have different MPNs.
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 Canada, India, and Russia. This attribute is recommended for Canada, India, and Russia.
Type Boolean: TRUE or FALSE
Text/Tab delimited FALSE
XML <g:identifier_exists>FALSE</g:identifier_exists>