Follow

Google Shopping data feed specification

Optimizing your data feed for Google is easy. Merchants on Magento, Shopify and numerous other Shopping Carts are using DataFeedWatch to create a feed that is in line with all Google feed requirements:

Feed format: xml or csv

Upload options: HTTP, HTTPS, FTP, SFTP, Google Spreadsheet. More

Categories: not required, Google taxonomy

Full feed specification: Google

Feed sample: sample

Google fields description

Fields with * are required.  

id*

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. 

title*

Name of your item. We recommend you include characteristics such as color or brand in the title which differentiates the item from other products.  

description*

A text describing your item. Includes only information relevant to the item. Do not include any promotional text such as "Free shipping", do not use BLOCK CAPITALS, and do not include a description of your store.

google_product_category*

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.

product_type (highly recommended)

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.

link*

A link to a product page. Landing pages requiring sign ups, passwords, or direct links to files/email addresses are not allowed. Links should not contain raw ip addresses.  

image_link*

This is the URL of an associated image for a product. Submit full-size images for your products and do not submit thumbnail versions of the images. For all apparel products, Google requires images of at least 250 x 250 pixels and recommends images of at least 400 x 400 pixels. If you have multiple images of the item, submit the main view using this attribute, and include all other views in the 'additional image link' attribute.  

price*

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. All submitted prices must exactly match the price displayed on your website. If you do not provide a currency with the price (e.g. 15.00 USD), Google will assume the currency is the same as that of your target country.  

condition*

Describes the condition of your product. Accepted values are: 'new', 'refurbished' and 'used'.  

availability*

Stock status of your product. Accepted values are: 'in stock', 'out of stock', 'available for order', 'preorder'.  

brand*

Brand of the product. This is required for all product UNLESS 1) You have already added GTIN and MPN or 2) You sell books, media or custom made products  

gtin

Global Trade Item Numbers (GTINs) for your products. These identifiers include UPC (in North America), EAN (in Europe), JAN (in Japan), and ISBN (for books).  

mpn

The manufacturer product number. Uniquely identifies the product to it's manufacturer.  

item_group_id

All items that are color/material/pattern/size 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'.  

google_product_category

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. Please use the "Categories" tab to add Google categories.  

additional_image_link

This is the URL of an additional image for a product. For example, if you have images that show the product from a different angle than the main image.  

sale_price

Use this attribute to submit the advertised sale price of the item. When a sale is active, the sale price will be shown as the current price in Google Shopping search results.  

sale_price_effective_date

Used in conjunction with sale price. This attribute indicates the date range during which the sale price applies. 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. Example: 2011-03-01T13:00-0800/2011-03-11T15:30-0800  

gender

Defines the gender of an item. Accepted values are: 'Male', 'Female' and 'Unisex'.  

age_group

Defines the age group of an item. Accepted values are: 'Adult', 'Kids'.  

color

Defines the dominant color of an item.  

size

Defines the size of an item.  

material

The material or fabric that a product is made out of.  

pattern

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.  

shipping_weight

This is the weight of the product used to calculate the shipping cost of the item. If you have specified a global shipping rule that is dependent on shipping weight, this attribute will be used to calculate the shipping cost of the item automatically.  

adwords_grouping

Used to group products in an arbitrary way. It can be used for Product Filters to limit a campaign to a group of products, or Product Targets to bid differently for a group of products. It can only hold one value. Example: Set adwords_grouping based on price ranges to bid differently on products of different values.  

adwords_labels

Used to group products in an arbitrary way. It can be used for Product Filters to limit a campaign to a group of products, or Product Targets to bid differently for a group of products. It can only hold multiple values. Example: Set adwords_labels based on color and size to bid differently on products of different colors and sizes. You can easily create AdWords Labels in the AdWords Labels tab  

excluded_destination

By default, your items will also appear in Google Commerce Search if you’re submitting to Google Shopping. Include this attribute if you are using either Google Shopping or Commerce Search and you would like to exclude the item from either of these destinations. Accepted values are: Shopping and Commerce Search  

online_only

Required only if you've submitted your store locations, and you have items that you sell online but not in your physical stores. Accepted values are: 'y', if any item is not available in your store to purchase or 'n' if a customer can buy the posted item at your physical location.  

expiration_date

This is the date that an item listing will expire. If you do not provide this attribute, items will expire and no longer appear in Google Shopping results, 30 days after your last update. You cannot use this attribute to extend the expiration period to longer than 30 days. Format: YYYY-MM-DD. Example: 2004-08-19.  

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 attribute.

adult

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

multipack

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.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

  • Avatar
    Vaibhav Shahu

    Can you please give sample file csv format. I download your sample file it name as csv but it in xml format.

    You said csv is supported but it is not supported.

    I have one query : How to update product value in Google shopping feed. Can you please tell me the steps ?

Powered by Zendesk