In this Help Centre, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure that you're using the article for the Merchant Center version that applies to you. 

Quantity [quantity]

Use the quantity [quantity] attribute to show the quantity of in-stock products in your shop.

In this article

When to use

Optional Optional for Shopping ads, local inventory ads and free local listings.


Follow these formatting guidelines to make sure that Google understands the data that you're submitting.

Learn when and how to submit your product data in English

Type Integer
Text/tab-delimited example 4
XML example <g:quantity>4</g:quantity>
To format your data for Content API, go to the Content API for Shopping resource.

Minimum requirements

These are the requirements that you need to meet to show your product in local inventory ads and free local listings. If you don't follow these requirements, your local products won't be eligible to serve.

  • Provide the quantity [quantity] attribute for each product and shop combination.

  • For inventory feed, quantity must be 0 or more.

Best practices

These best practices can help you to go beyond the basic requirements to optimise your product data for performance.


Note: While quantity [quantity] is optional, availability [availability] is mandatory for ads to run.

Availability [availability] must be submitted as a text string with one of four accepted values:

  • 'in stock'
  • 'out of stock'
  • 'limited availability'
  • 'on display to order'

If you decide to submit quantity [quantity], this is how you match your availability [availability]: if there are three or more available, the product is considered to be 'in stock'. If there are one to two available, the product is considered to have 'limited availability'. If there are none available, the item is considered to be 'out of stock'.

Availability Number
In stock 3+
Limited availability 1–2
Out of stock 0
Temporarily out of stock 0
On display to order 1


Feed Field Description Type Examples
Sales quantity [quantity] The number of products of this kind that are sold and returned in a transaction.


'Positive' for sold and 'Negative' for returned



Inventory quantity [quantity] The quantity of the product.


>= 0


Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Centre