Control how products can be ordered — minimum quantities, maximum quantities, step values (case packs), default quantities, and backorder behaviour. Apply globally or per role, per product, or per category.
Force a minimum units per line item. "You must order at least 6." Shown as a clear message on the product page.
Cap how many units can be ordered in one go — for compliance, stock allocation, or promotional limits.
Force ordering in multiples. Step of 12 means the selector only allows 12, 24, 36, 48… Perfect for case-pack wholesale.
Set the pre-filled quantity on product pages. New visitors see the quantity already set to your standard case size.
Different rules per user role. Wholesale Gold can order a minimum of 24; Wholesale Bronze has a minimum of 12; retail has no minimum.
Write your own message that appears when the buyer tries to checkout with an invalid quantity. Explain the requirement clearly.
Go to B2B Commerce Kit → Tools → Features → Quantity Rules and toggle on.
Go to B2B Commerce Kit → Quantity Rules → Add New. Name it (e.g. "Bottles — Case Pack").
Enter Min Qty, Max Qty, and Step values. Leave blank to skip any constraint. Set Default Qty to pre-fill the quantity selector.
Choose which products (all, specific products, categories, Product Lists) and which users (all, specific roles, User Lists) this rule applies to.
Customise the cart and product-page messages explaining the quantity requirement to buyers.
Min 12, Step 12 for all wholesale buyers. Discount Rule adds 5% off at 24+, 10% at 48+. Buyers must order in cases, and are rewarded for buying more cases.
Per-product case pack enforcement (Quantity Rules) combined with a minimum order value for the whole cart (Order Restrictions).
| Field | Description | Example |
|---|---|---|
Min Quantity | Minimum units per line item. Checkout is blocked if below this. | 12 |
Max Quantity | Maximum units per line item. Cart quantity is capped at this value. | 144 |
Step | Quantity increments. Step of 6 means only 6, 12, 18, 24… are valid. | 6 |
Default Quantity | Pre-fills the product page quantity selector with this value. | 12 |
Error Message | Custom message shown when a buyer's quantity violates the rule. | "Please order in multiples of 12" |
Yes. Create two Quantity Rules for the same product: one targeting Wholesale Gold (min 24) and one targeting Wholesale Bronze (min 12). Role-specific rules take precedence over general rules. If both match, the more specific one (by role) wins.
Yes. Quantity validation runs on both the product page (quantity selector is constrained) and at cart/checkout (a rule violation blocks checkout and shows the error message). Even if a buyer somehow adds an invalid quantity, checkout is blocked.
Yes. The woob2b_min_quantity filter hook runs after all rule evaluation. You can return a modified minimum — for example, new accounts (registered less than 90 days ago) must order at least 24 while established accounts have the standard 12. See the Hooks reference for an example.