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

Format

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 (JSON)	`"customAttributes": [ { "name": "purchase_quantity_limit", "value": "10" } ]`

To format your data for Content API, see the Content API for Shopping.

Guidelines

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.

Examples

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.