This example prevents a customer from purchasing more than 3 items in total from a specific collection. Whichever products in the collection they buy, the quantities are combined.
Prerequisite: Cumulative quantity rules are a Full plan feature. To use them, cumulative purchase limits must be enabled.
A customer whose total for the collection is under 3: purchase is allowed.
A customer whose total has reached 3: purchase is not allowed.
A customer who is not logged in: they are asked to log in at checkout.
The following shows how a collection containing Product A and Product B is evaluated.
Purchased so far | Cart contents | Result |
|---|---|---|
None | Product A × 3 | Allowed |
None | Product A × 2 + Product B × 2 | Not allowed (4 in total) |
Product A × 2 | Product B × 1 | Allowed (3 in total) |
Product A × 3 | Product B × 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 | 3 |
Require customers to log in | Enabled |
Eligible items | Specific collections (the collection to limit) |
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 from this collection. 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 from this collection to one order. |
(4) Enable the cumulative quantity rule
Select "Enable" on the rule details screen. Saving alone does not apply the limit.
Setting "Counted per" to "Whole rule" keeps one total no matter which products in the collection are purchased. To allow 3 of each product, select "Product" instead.
You can specify up to 50 collections per rule.
If you change what is in the collection, orders placed after the change are counted against the new set of eligible items. Past orders are not recounted.
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.