There are four quantity limit methods: quantity rules, quantity limits by product, quantity rules by customer group, and cumulative quantity rules. Choose a method, configure and enable it, then check its behavior.
Choose the method to use depending on the unit you want to limit.
Method | Best suited for | Applicability options |
|---|---|---|
Quantity rules | Limiting a broad scope or a combined total quantity at once | Cart, Product, Variant |
Quantity limits by product | Changing the limit depending on the product | Product, Variant |
Quantity rules by customer group | Varying purchase limits or order multiples by customer group | Cart, Product, Variant |
Cumulative quantity rules | Setting a per-customer limit on the total purchased across orders | Whole rule, Product, Variant |
Before creating a quantity rule, choose a pricing plan from "Pricing" in the app admin.
Prerequisite: A test contract for a pricing plan is required even when testing on a development store. Under Shopify's specifications, test contracts are free.
Prerequisite: To use quantity rules by customer group or cumulative quantity rules, subscribe to the Full plan. Quantity rules and quantity limits by product are available on the Light plan as well.
(1) Open Quantity rules
Open the app admin → "Quantity limits" → "Quantity rules".
(2) Add a quantity rule
Select "Add quantity rule".
(3) Save the settings
Configure the required fields and save.
You can configure the following for a quantity rule.
Settings | Description |
|---|---|
Title | The rule name for internal use |
Limit details | Minimum quantity, maximum quantity, increment |
Applicability | Cart, Product, Variant |
Eligible items | All items, a specific collection, specific products, or products with a specific tag |
Product message | The message shown on the product page (optional) |
Alert message | The message shown when the limit is violated |
(4) Enable the quantity rule
For a quantity rule, select the rule in the list and choose "Enable rule", or select "Enable" on the edit screen.
(1) Open Quantity limits by product
Open the app admin → "Quantity limits" → "Quantity limits by product".
(2) Start using it
Select "Start using". This prepares the settings for products and variants.
(3) Enable quantity limits by product
Open "Settings" and select "Enable". This creates and enables a dedicated checkout rule.
(4) Set the quantity for each product or variant
For the eligible products, select "Edit total quantity target" or "Edit each variant limit", then select "Save changes".
(1) Open the create screen
Open the app admin → "Quantity limits" → "Quantity rules by customer group", then select "Create rule".
(2) Set customer groups and quantities
Add groups based on customer tags or a customer metafield, and configure their limits. Also check member and guest settings and the priority of added groups.
(3) Set eligible items and save
Set applicability, eligible items, and messages, then save.
(4) Enable the rule
Select "Enable" on the details screen. Added groups match logged-in customers only. Customers who are not logged in use the guest limit.
(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". The app can then read order and customer information and store each customer's total.
Note: Once cumulative purchase limits are enabled, they cannot be turned back off. To stop limiting, disable or stop an individual rule instead.
(3) Create a cumulative quantity rule
Select "Create rule", then set the maximum quantity, eligible items, what the total is counted per, and the messages, and save.
(4) Enable the cumulative quantity rule
Select "Enable" on the rule details screen. Tracking starts when you create the rule; past orders are not counted retroactively.
Enabling the app embed is a recommended setting. It is required if you want to use product messages and quantity picker control. If you only use quantity limits at checkout, this step is not necessary.
(1) Open the theme editor
Open Shopify admin → "Online Store" → "Themes" → "Customize".
(2) Open App embeds
Select the "App embeds" tab at the bottom left of the theme editor.
(3) Enable RuffRuff Order Limits
Enable "RuffRuff Order Limits" and save.
Note: Quantity limits are still enforced at checkout even if you don't enable the app embed. The app embed is required for product messages and quantity picker control.
If the display timing is "Cart updated and checkout," check in the cart. If it is "Checkout only," proceed to checkout to check. For a cumulative quantity rule, the evaluation that includes past purchases happens at checkout.
For quantity rules by customer group, check each added group, other logged-in members, and guests. Group matching depends on login status; entering an email address alone is not sufficient to test a logged-in group.
Chose a pricing plan
Set up the quantity limit using the method you use
Enabled the quantity limit
Enabled cumulative purchase limits, if you use cumulative quantity rules
Enabled the app embed (recommended; required if you use product messages or quantity picker control)
Checked the behavior according to the display timing
Product Quantity Rules: Settings
About Quantity Limits by Product
Quantity Limits by Product: Settings
About Cumulative Quantity Rules
Cumulative Quantity Rules: Settings
Development Stores