Maximum purchase quantity [purchase_quantity_limit]

You may want to place a limit on the purchase quantity allowed for certain items, for example, items on promotion. Use the maximum purchase quantity [purchase_quantity_limit] attribute to let customers know the limit on the number of items they can buy in a single order. If you don't specify a number using this attribute, Google may limit the maximum purchase quantity for your product.

When to use

  • Optional for each product


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

For details on when and how to submit values in English, learn more about submitting your product data

Type Number
Supported values Any positive integer, 1 or greater
Repeated field No
File format Example value
Text feeds 4
XML feeds <g:purchase_quantity_limit>4</g:purchase_quantity_limit>

If you choose to use the Content API to add this attribute, you’ll need to use the custom attributes feature.
File format Example value
Content API
"customAttributes": [
    "name": "purchase_quantity_limit",
    "value": "10"
To format your data for Content API, see the Content API for Shopping.


Follow these guidelines to make sure you submit high-quality data for your products.

Minimum requirements

These are the requirements you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page in your Merchant Center account.

  • Only provide this attribute when there is a realistic limit on how many items your consumers can purchase in one order.
  • You must add a quantity of 1 or more.


Product is available for sale on Google

Product data for an Android Squishable
Attribute Value
Availability [availability] in_stock
Maximum purchase quantity [purchase_quantity_limit] 10

Need help? Click here to contact Buy on Google support.

Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center