Make Your Products Purchasable in Quantity Increments
Restrict product purchases to fixed quantity multiples, customers can only buy in packs, cases, or bundles you define.
The Quantity Increment feature allows you to set fixed quantity steps for your products, meaning customers can only purchase items in multiples of a specific number, for example, 5, 10, 15, and so on.
This is especially useful for B2B or wholesale stores, where products are often packed or sold in predefined units. By enabling this feature, you can ensure that all orders follow your packaging rules, simplify inventory control, and maintain a professional wholesale experience.
How to Enable and Configure Quantity Increments
Section titled “How to Enable and Configure Quantity Increments”The rule page has the cards Rule, Customers, Products, Quantity rule, Exclusions (optional) and Advanced (priority). When several rules match the same product and customer, the lowest Priority number wins.
-
Access the Feature
Section titled “Access the Feature”- In the app, go to B2B orders & discounts > Quantity Increments.
- Click Turn on Quantity Increments, or use the switch next to the title. The Setup row under the title shows the state of Module, App embed and Active rule.

- Click Add quantity rule. When the list already has rules, it shows Quick create and Add rule instead.

On a rule page, the Make Quantity Increments live card lists what is still missing, for example Turn on module.

-
Define the Scope
Section titled “Define the Scope”Start with the Rule card: a Name and a Status.

Each rule needs two conditions: who it applies to, and which products it covers.
Apply to customers
- All customers
- Logged-in customers only
- Not logged-in customers only
- Specific customers
- Customer tags

Apply to products
- All products
- Specific products
- Product collections
- Product tags
- Specific variants

With Specific products, tick the products the rule covers in the Select products dialog:

You can also exclude specific customers or customer tags from the rule in the Exclusions (optional) card.
-
Set the Increment Value
Section titled “Set the Increment Value”Enter the Quantity increments value: the step customers must buy in, a whole number from 1 to 30,000.
Value Allowed quantities 5 5, 10, 15, 20… 6 6, 12, 18, 24… 12 12, 24, 36, 48… 
-
Set Min and Max, then Save
Section titled “Set Min and Max, then Save”Optionally set Min and Max to bound the rule:
- Min: the smallest quantity a buyer may order. The selector starts here and cannot go below it. It must be at least the increment value and below the maximum; use a multiple of the increment (for example 12 with a step of 6).
- Max: the largest quantity a buyer may order, at least the minimum. Leave it empty for no ceiling.
Both are in the Quantity rule card and optional. If you leave the minimum empty, the increment value itself acts as the floor.
Click Save. The rule activates immediately on matching products.
How It Works on the Storefront
Section titled “How It Works on the Storefront”- Step Increment Buttons: Clicking
-or+steps by the configured increment value (e.g., 5, 10, 15…). - Auto-Correct Typed Quantities:
- When buyers type a quantity into the input box, the app corrects it to the nearest valid multiple of the step increment: it rounds up if the entered number is at or past the halfway point between two steps, and down if it is below the halfway point. With a step of 10, typing
16becomes20, while typing12becomes10. - If the typed quantity is below the minimum threshold or exceeds the maximum, the input automatically snaps to
minormax. - If the input box is cleared empty, it automatically resets to the
minincrement value.
- When buyers type a quantity into the input box, the app corrects it to the nearest valid multiple of the step increment: it rounds up if the entered number is at or past the halfway point between two steps, and down if it is below the halfway point. With a step of 10, typing
- Where it is enforced:
- Product Detail Pages (PDP): full enforcement: stepper, typed input and add-to-cart.
- Collection / Catalog Listing Pages and Quick-View Modals: enforcement applies to the quantity controls the app can attach to. Some themes render listing cards without a quantity selector at all, in which case there is nothing to correct on that page and the limit is applied once the buyer reaches the product page or the cart.
- Cart Page: with Cart enforcement turned on (see Settings below; the switch is not shown on storefront version 5), buyers cannot alter line-item quantities inside the cart to invalid step increments (for Variant quantity rules). It is off by default.
For example, with an increment of 5, each click on the − or + button on the quantity selector changes the quantity by 5.

If a customer types 22, for example, the input automatically rounds to the nearest valid step and shows 20:

Quantity Increments Calculation
Section titled “Quantity Increments Calculation”In Quantity increments calculation, choose what the step is counted on:
| Level | Description |
|---|---|
| Variant quantity | Each variant must be purchased in separate increments. Example: 5 Black + 5 White = valid (not 5 total across both) |
| Product quantity | The combined quantity across all variants of a product must be a multiple of the increment |
| Order quantity | The total quantity across all qualifying products in the cart must be a multiple of the increment |
On collection pages, quick-order lists and other listings, only Variant quantity rules are applied. Product quantity and Order quantity rules are checked on the product page and in the cart.
Settings
Section titled “Settings”Go to Quantity Increments > Settings:
Cart enforcement: the card reads “Apply your active quantity rules in the cart and on quick add, even where your theme shows no rule message.” The switch is not shown if your store uses storefront version 5. It is off by default, and it saves right away, so you do not need to click Save.

Messages shown on the product page: Yes shows a hint with the step (and min/max) next to the quantity selector, with Message position Below quantity selector or Below the “Buy it now” selector. The hint turns red when the quantity is not valid. With No (default), a short error only appears when the quantity is wrong.

Notification pop-up modal design: the colors of the pop-up that blocks checkout when a cart quantity does not match (header and content background and text).

Translations (a button on the Quantity Increments page): edit the Inline requirement message on Product Page/ Collection Page and the Cart/Product pop-up texts, per language.
Export Rules
Section titled “Export Rules”On the rule list, click More actions, then Export to download all rules as a CSV (name, priority, status, conditions, increment, calculation, min and max). The export runs in the background; the download link stays valid for 24 hours.

Example
Section titled “Example”A beverage distributor sells 6-pack bottles. Setting increment = 6 means:
- Valid: 6, 12, 18, 24…
- Invalid: 7, 11, 15… (customer is prompted to adjust)
Benefits
Section titled “Benefits”- Consistent Order Sizes: Prevent random order quantities that disrupt packaging or logistics.
- Professional Wholesale Flow: Align your store with standard B2B purchase behavior.
- Error-Free Checkout: Avoid order mismatches and improve the customer shopping experience.
- Boost Average Order Value: Encourage customers to purchase in bulk naturally.
By setting Quantity Increments, you make it easier for customers to shop while ensuring your store runs smoothly and professionally, a perfect combination for growing your wholesale business.
- Invoice PDF Add-on: Order Summary PDFs, Price, Free TrialInvoice PDF creates a PDF order summary for Net Terms and B2B orders and can email it to the buyer. See the price, the free trial and how to turn it on.
- Manual OrdersThe Manual Orders module lets you create draft orders on behalf of your B2B customers directly from the app, with all wholesale pricing rules applied automatically.
- Net termsNet Terms lets approved B2B customers place orders now and pay later within a payment term you set, using a Pay later button in the cart.
- Order LimitsOrder Limits lets you set minimum and maximum purchase thresholds for your B2B customers, by item quantity or order value.