541.201.9965 Support_Email
Display Legacy Contents

Home > Channels (Feeds) > Google Shopping > Google Shopping - Data Dictionary (Section 2)

Google Shopping - Data Dictionary (Section 2)


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. The freshness and frequency of the data feed is one of the many bonuses of using DotFeed to manage your rules.

Google regularly checks these attributes, and if the values provided in these attributes are found to be different from the information presented on your website, Google will remove all your items from Product Search. Please see their policies for more details.


Definition of Google Availability

availability [availability] - Availability status of the item 


DotFeed will assume a value of "in stock", so you should use the mapping rules to reset those where, perhaps, your inventory defies a status of "in stock".

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.'
  • 'preorder': You are taking orders for this product, but it’s not yet been released.

When to include: Required for all items in feeds targeting the US, Japan, UK, Germany, France. Recommended for feeds targeting all other countries (although might become required in the future).


  • 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. (Note: It is acceptable to include 'available for order' in your feed and note "out of stock" on your website.)
  • Items that are no longer sold have to be removed from the feed entirely.


Definition of Google Price

price [price] - Price of the item

DotFeed will extract and feed this information for you.

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.



  • For the US, don't include tax in the price. For all other countries, value added tax (VAT) has to be included in the price.
  • ISO 4217 Standard.
  • Make sure to read Google's policies in detail. Only items with fixed prices are allowed in Product Search. 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 the most prominent 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 the most prominent price on the page.


Definition of Google Sale Price

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

DotFeed will extract and feed this information for you.


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.



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

sale price effective date [sale_price_effective_date] - Date range during which the item is on sale 
If you are declaring a sale, then you will need to use the DotFeed rules engine to set your Sale start date.

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.

See also