purchase_quantity_limit: Definition

You may want to place a limit on the purchase quantity allowed for certain items, for example, items on promotion. Use the 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 we understand the data you're submitting. 

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 Diagnostics 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 Android Squishable
availability in stock
purchase_quantity_limit 10

Need help? Click here to contact Shopping Actions support.

Was this helpful?
How can we improve it?