Quick answer
On this page
For Shopify B2B, use catalog quantity rules for pack increments and minimum/maximum quantities, and catalog volume pricing for quantity breaks. These rules apply to individual variants in the buyer’s catalog context. Do not enforce wholesale pack sizes only with a theme quantity selector or recreate catalog price breaks with a custom discount script. Make the theme display the native rules, then verify the same buyer and company location in cart and checkout.
Why a wholesale order matrix can disagree with checkout
A wholesale buyer chooses 5 blue shirts and 5 gray shirts. The theme accepts the 10-unit total, but checkout rejects the order because the catalog requires increments of 10 per variant. Or a buyer expects a 20-unit price break because the cart contains 20 shirts across colors, but the price break applies only after one variant reaches 20. The theme may also show a lower price that does not match the catalog context of the company location currently purchasing.
Older wholesale implementations often stored pack sizes in tags, used theme JavaScript to force multiples, and applied price breaks with apps or legacy Shopify Scripts. Shopify now has native B2B catalog quantity rules and volume pricing. Those should be evaluated before building a parallel system.
Separate the two rules
Quantity rules define the minimum, maximum, and increment for a variant. If the increment is 6 and minimum is 12, valid quantities begin at 12 and continue 18, 24, 30, subject to any maximum. These are purchase constraints, not discounts.
Volume pricing defines the unit price at specified quantity thresholds. A variant may be $20 each until 20 units, $18.50 from 20, and $17.75 from 50. Shopify allows up to 10 price breaks per product, applied to variants. A variant must reach its own threshold. Once a fixed volume price is configured, the catalog’s overall adjustment discount does not also apply to that price.
In Shopify Admin, open Markets → Catalogs, choose the catalog, then Manage → Manage products and pricing in the Products and pricing section. Configure quantity rules and volume pricing for the appropriate products or variants. A buyer can be assigned different catalogs through different B2B company locations, so verify which catalog is actually in context before blaming the theme.
Read the native rules in Liquid
Shopify exposes variant.quantity_rule and variant.quantity_price_breaks in Liquid for the current customer context. This compact example displays the selected variant’s minimum, increment, optional maximum, and price breaks:
{% assign v = product.selected_or_first_available_variant %}
{% assign rule = v.quantity_rule %}
<p>Minimum: {{ rule.min }} · Increment: {{ rule.increment }}</p>
{% if rule.max != blank %}
<p>Maximum: {{ rule.max }}</p>
{% endif %}
{% if v.quantity_price_breaks.size > 0 %}
<ul>
{% for tier in v.quantity_price_breaks %}
<li>{{ tier.minimum_quantity }}+: {{ tier.price | money }} each</li>
{% endfor %}
</ul>
{% endif %}
This is a display example, not a complete variant-aware quantity component. If the buyer switches variants, the visible rules and tiers must be refreshed too. Modern Shopify themes already support much of this; check the theme version before adding custom code. Shopify documents quantity rules in its free themes from version 8.0.0 and volume pricing from version 11.0.0.
Keep quantity controls honest
Initialize the input at the native minimum. Use the increment for step controls, but do not assume an HTML step attribute alone guarantees valid quantities. Validate manual input, cart drawer edits, quick-add, and bulk order matrix submissions against the selected variant’s rules. If your UI groups several variants into a single row, calculate and show validation per variant before submitting.
When the cart contains multiple lines for the same variant, check the effective quantity Shopify uses for the purchase. A line-item property, selling plan, or other characteristic can cause separate lines in a custom cart. Do not blindly sum unrelated variants to qualify for a price break. Let Shopify calculate the final catalog price rather than manually setting a lower price in the browser.
Where custom logic still belongs
Native quantity rules do not replace every wholesale workflow. A future shipping window, cumulative availability across preorders, embroidery approval, or an ERP allocation rule is not the same thing as a per-variant catalog minimum. Those may need a separate app, draft-order flow, or server-side validation. Keep them distinct so a buyer does not confuse “must order in packs of 6” with “6 available to ship next month.”
For a headless storefront, read quantity rules and quantity price breaks through the Storefront API in the correct buyer context, rather than copying public retail prices into a B2B cart. If the storefront and cart disagree, inspect buyer identity and company-location selection first, then the catalog, then the UI. The wrong context can produce a perfectly valid price for the wrong buyer.
Common misunderstanding
“Twenty units across the product should earn the twenty-unit tier.” Shopify’s B2B quantity rules and volume breaks are variant-scoped. Ten blue plus ten gray is not twenty of either variant. A custom matrix that presents product-level totals must still explain and enforce variant-level eligibility.
How to test this
- Create a B2B catalog test product with two variants, an increment of 6, a minimum of 12, and price breaks at 18 and 30. Assign the catalog to a test company location.
- Log in as a buyer purchasing for that location. Verify the PDP shows the minimum, increment, and tiers for each selected variant.
- Try quantities 6, 12, 17, 18, and 30. Confirm invalid values are rejected and valid quantities display the expected price break in cart and checkout.
- Add 12 of one variant and 6 of another. Confirm the second variant does not borrow the first variant’s quantity to meet its own minimum or tier.
- Switch to another company location with different catalog pricing. Refresh the page and cart and verify both use the new context.
- Repeat using quick-add, cart drawer edits, bulk order forms, and a mobile viewport. Check whether your theme updates the displayed rule when variants change.
Sources and further reading
- Shopify Help: B2B quantity rules and volume pricing
- Shopify Help: Display rules and volume prices in themes
- Shopify: Liquid variant quantity_rule and quantity_price_breaks
- Shopify: Liquid quantity_price_break
- Shopify Dude: B2B draft orders and purchasing context
Technical references checked October 26, 2026.

