Order constraints (MOQ & max)
Order constraints let you enforce minimum and maximum quantity requirements for B2B orders placed through the Variant Drawer.
Available constraints
MOQ per variant
Field: moqPerVariant
Sets the minimum quantity a customer must order for each individual variant they select. If a customer adds a variant to the order, they must add at least this many.
0
No minimum per variant (default)
2
Customer must order at least 2 of any variant they add
5
Customer must order at least 5 of any variant they add
Example: With MOQ per variant = 2, a customer ordering a T-shirt in "Red / M" must order at least 2. They can skip "Red / L" entirely, but if they add it, they must add at least 2.
MOQ per product (total)
Field: moqPerProductTotal
Sets the minimum total quantity across all variants combined. The customer can distribute the quantity however they like across variants, as long as the total meets the minimum.
0
No total minimum (default)
10
Customer must order at least 10 total across all variants
50
Customer must order at least 50 total across all variants
Example: With MOQ total = 10, a customer could order 3 Red/M + 3 Red/L + 4 Blue/S = 10 total. Any combination that sums to 10 or more is valid.
Max qty per variant
Field: maxQtyPerVariant
Sets the maximum quantity allowed for any single variant. Prevents customers from over-ordering a specific size or color.
0
No upper limit (default)
100
Customer can order up to 100 of any single variant
500
Customer can order up to 500 of any single variant
Validation behavior
When constraints are configured, the Variant Drawer enforces them in real time:
MOQ notice — A highlighted notice appears at the top of the drawer body showing the minimum requirements (e.g. "Min 2 per variant. Min 10 total.").
Submit validation — The action buttons (Add to Cart / Start Order) validate constraints before submitting. If the order doesn't meet requirements, a validation message appears in the footer.
Stepper limits — The quantity stepper respects the max qty per variant setting. Customers cannot increment beyond the maximum.
Combining constraints
You can use all three constraints together. For example:
MOQ per variant
2
Each added variant needs at least 2
MOQ total
12
Must order 12+ total
Max per variant
50
No single variant can exceed 50
This setup means: order at least 12 items total, with at least 2 per variant you include, and no more than 50 of any single variant.
Note: If MOQ per variant is greater than Max per variant, a warning appears in the editor: "Min must be less than or equal to max."
Setting up constraints
Open the Variant Drawer rule in the editor
Navigate to Order Constraints in the left sidebar
Set the desired values (leave at 0 to disable any constraint)
The live preview shows the MOQ notice banner in the drawer
Click Save
Last updated
Was this helpful?