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

• Optional for each product

This attribute has 3 sub-attributes:

• Section name [section_name] (Optional but recommended)
• Attribute name [attribute_name] (Required)
• Attribute value [attribute_value] (Required)

Format

Follow these formatting guidelines to make sure we understand 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	Android Squishable
availability	in stock
purchase_quantity_limit	10

Need help? Click hereto contact Buy on Google support.