Product quantity rules let you restrict the number of items that can be purchased per variant, per product, or across the entire cart. By combining Minimum quantity, Maximum quantity, and Increment, you can accommodate a wide range of sales scenarios.
Field | Description |
|---|---|
① Title | The name used to identify the rule |
② Limit details | Configure Minimum quantity, Maximum quantity, Increment, and Applicability |
③ Eligible items | Specify the products, collections, or tags the restriction applies to |
④ Product message | Message displayed below the Add to cart button on the product page |
⑤ Alert message | Message displayed at checkout when a restriction is violated |
The name used to identify the rule. It is displayed only in the rule list in the admin and is never shown to customers. When creating multiple rules, we recommend using distinct names that are easy to tell apart.
Configure the purchase quantity restrictions.
Field | Description |
|---|---|
Minimum quantity | The minimum quantity that can be purchased. Required. |
Maximum quantity | The maximum quantity that can be purchased. Optional. |
Increment | Restricts purchases to multiples of the specified number. Optional. |
Applicability | Sets the unit at which quantity is counted: per variant, per product, or across the cart. |
About Increment
Setting an increment means customers can only check out with quantities that are multiples of the specified number. For example, setting it to 3 allows purchases of 3, 6, 9, 12, and so on. By setting Minimum quantity and Increment to the same value, you can require customers to purchase at least one full set.
About Applicability
Value | Description |
|---|---|
Variant | Limits the quantity per variant. |
Product | Limits the total quantity across all variants of a product combined. |
Cart | Limits the total quantity of eligible items across the entire cart. |
When Applicability is set to Cart, Display timing is automatically fixed to Checkout only.
Specify the scope of products the restriction applies to.
Value | Description |
|---|---|
All items | Applies the restriction to all products in the store. |
Specific products | Applies the restriction only to the specified products. |
Specific collections | Applies the restriction to products included in the specified collections. |
Products with specific tags | Applies the restriction to products with the specified tags. |
The message displayed below the Add to cart button on the product page. Use this to inform customers of purchase conditions before they add items to their cart. Leave blank if not needed. Variables can be used in product messages to dynamically display configured values.
Variable | Description |
|---|---|
{{minQuantity}} | Replaced with the configured Minimum quantity. |
{{maxQuantity}} | Replaced with the configured Maximum quantity. |
{{increment}} | Replaced with the configured Increment. |
To display product messages, the app embed must be enabled in your theme. See the "Product Message" page for details.
The message displayed at checkout when a restriction is violated. If left blank, no alert will be displayed. Variables can be used in alert messages to dynamically display configured values.
Variable | Description |
|---|---|
{{minQuantity}} | Replaced with the configured Minimum quantity. |
{{maxQuantity}} | Replaced with the configured Maximum quantity. |
{{increment}} | Replaced with the configured Increment. |
Display timing
You can choose from the following two options for when the alert message is displayed (i.e., when the restriction check is run).
Value | Description |
|---|---|
Cart updated and checkout | Runs the restriction check when items are added to, removed from, or updated in the cart, and at checkout. |
Checkout only | Runs the restriction check at checkout only. |
For details on display timing, see the "Alert Message" page.