This example prevents a customer from purchasing more than 5 items in total across every product in the store. Quantities are combined regardless of which products they buy.
Prerequisite: Cumulative quantity rules are a Full plan feature. To use them, cumulative purchase limits must be enabled.
A customer whose total is under 5: purchase is allowed.
A customer whose total has reached 5: no product can be purchased.
A customer who is not logged in: they are asked to log in at checkout.
Purchased so far | Cart contents | Result |
|---|---|---|
None | Product A × 5 | Allowed |
Product A × 3 | Product B × 2 | Allowed (5 in total) |
Product A × 3 | Product B × 3 | Not allowed (6 in total) |
Product A × 5 | Product C × 1 | Not allowed (limit reached) |
(1) Open Cumulative quantity rules
Open the app admin → "Quantity limits" → "Cumulative quantity rules".
(2) Enable cumulative purchase limits
Grant the additional permissions and select "Enable". If they are already enabled, skip this step.
(3) Enter the settings and save
Select "Create rule", configure the following, and save.
Field | Value |
|---|---|
Rule name | Any internal name |
Maximum quantity | 5 |
Require customers to log in | Enabled |
Eligible items | All products |
Counted per | Whole rule |
Message (signed-in customers) | Enter if needed |
Message (customers who are not logged in) | Text asking the customer to log in |
Checkout message (signed-in customers) | Example: You can purchase up to {{limit}} items in total from this store. You can purchase {{remaining}} more. |
Checkout message (customers who are not logged in) | Text asking the customer to log in |
Cart message | Example: You can add up to {{limit}} items in total to one order. |
When you select "All products" as the eligible items, the total can only be counted per "Whole rule". Counting per product or per variant is not available.
(4) Enable the cumulative quantity rule
Select "Enable" on the rule details screen. Saving alone does not apply the limit.
Note: Every product in the store is eligible. There is no setting to exclude specific products. If you need to exclude some, specify the eligible items by collection or product tag instead.
Gift wrapping and shipping-fee products are also counted. If there are products you do not want counted, reconsider how you specify the eligible items.
Only orders placed after you create the rule are counted. Customers who purchased before that are not limited.
If you disable "Require customers to log in", customers who are not logged in can also purchase. Purchases are counted when the email entered at checkout matches the customer record, but an order placed with a different email address lets them purchase again.
Changing the eligible items and what the total is counted per gives you limits like these.