Order minimums and quantity limits

What you’ll build: checkout rules like “orders must be at least $50” or “maximum 3 of this product per order”, with your own error message.

Requirements: More Functions or Business. Works on every Shopify plan.

These all use the checkout blocker. Remember that its rules describe when to block.

1. Click Create customization, filter Built as to Functions, and choose Checkout blocker.

2. Write an Error message that tells the customer how to fix it.

3. Choose Apply only when rules pass and Rule Set 1, then add the rule for your limit (see the table below).

4. Save function and test with a cart that breaks the rule and one that doesn’t.

Goal	Rule (blocks when true)	Example message
Minimum order value	Cart subtotal is less than 50	“Orders must be at least $50.”
Maximum items per order	Number of items is more than 10	“You can order up to 10 items at a time.”
Maximum of one product	Quantity of variants is more than 3, with the product’s variants selected	“Limit 3 per order.”
Minimum of each selected product	Cart products includes the variants AND Quantity of each variant is less than 2, with the same variants selected	“This item has a minimum of 2.”
No more of a free item than of the paid product	Free item quantity exceeds selected product quantity, with the paid product selected. Blocks when any single free line has a higher quantity than the paid product; never blocks if the paid product isn’t in the cart	“Only one free item per item purchased.”
Don’t mix subscriptions and one-time items	Cart contains both subscriptions and one time purchases	“Please check out subscriptions separately.”

Add several limits to one blocker

Click Add checkout validator to add another setting with its own message and rules. Each setting whose rules pass shows its own error.

Variations

• Minimums only for wholesale: add B2B customer exists (AND) to the minimum rule, or use Customer tags includes wholesale.
• Different minimums per market: create one blocker per market and use the Markets card.
• Minimum for local delivery only: use Rule Set 3 with Selected shipping option title includes Local delivery AND Cart subtotal is less than 30.

Things to know

• “Is less than” and “is more than” are strict. “Less than 50” blocks $49.99 but allows exactly $50.
• Amounts are in your store’s currency and converted for customers paying in another currency.
• The message shows at checkout, not in the cart, and at the top of the page rather than next to a product.
• Quantity of each variant needs a Cart products rule. On its own it also blocks carts that don’t contain the product at all. Add Cart products includes the same variants in a separate AND group.
• Number of items counts units (2 shirts + 1 hat = 3). Number of line items counts different products and variants (2).