This example prevents a customer from purchasing more than 2 of the same variant in total. Different variants are not combined, so each one can be purchased up to 2 times.
Prerequisite: Cumulative quantity rules are a Full plan feature. To use them, cumulative purchase limits must be enabled.
A customer whose total for that variant is under 2: purchase is allowed.
A customer whose total for that variant has reached 2: that variant cannot be purchased.
A customer who is not logged in: they are asked to log in at checkout.
The following shows how a product with size S and size M variants is evaluated.
Purchased so far | Cart contents | Result |
|---|---|---|
None | Size S × 2 | Allowed |
None | Size S × 2 + Size M × 2 | Allowed (counted separately) |
Size S × 2 | Size S × 1 | Not allowed (S has reached the limit) |
Size S × 2 | Size M × 2 | Allowed (M has not been purchased) |
(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 | 2 |
Require customers to log in | Enabled |
Eligible items | Specific products (the products or variants to limit) |
Counted per | Variant |
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}} of each variant of this product. 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}} of each variant of this product 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 "Variant" keeps a separate total for each size or color. To allow 2 across the whole product, select "Product" instead.
You can specify up to 50 products and up to 50 variants per rule.
The breakdown holds up to 250 entries per customer. Specifying many products with many variants at once can reach that cap, so splitting the rule by series or by set is recommended.
To limit quantity within a single order only, use a product quantity rule instead.
Only orders placed after you create the rule are counted. Customers who purchased before that are not limited.
Changing the eligible items and what the total is counted per gives you limits like these.