Engineering
9 min read
September 2026
How to add minimum order quantities to a Wix store using Velo
Built-in checkout requirements for standard rules, and custom Velo development when the business logic gets more specialised.
Not every online store can sell products in quantities of one.
Wholesale businesses, manufacturers, food suppliers, promotional product companies, packaging suppliers, and bulk retailers often need customers to purchase a minimum number of units before an order can be completed.
This requirement is commonly known as a Minimum Order Quantity (MOQ).
Examples of MOQ rules
- ·Minimum 10 units of a product
- ·Minimum 25 promotional items
- ·Minimum 6 candles
- ·Minimum 100 packaging units
- ·Minimum quantity based on a specific product
Wix now provides built-in checkout requirements for many common quantity rules. For more specialized business logic, however, custom development with Velo can still provide additional flexibility.
01
What is a minimum order quantity?
A Minimum Order Quantity defines the smallest number of units a customer can purchase for a product or order.
For example, imagine a wholesale store sells mugs with an MOQ of 12. A customer adds:
Mugs × 8
The website should recognize that the quantity is below the required minimum and prevent checkout or display a message asking the customer to increase the quantity. Once the customer changes the quantity to:
Mugs × 12
the order can continue. This type of rule can help businesses manage production, packaging, shipping, and wholesale economics.
02
Why do online stores need MOQs?
An MOQ can be useful when selling products where individual-unit orders are inefficient. Common examples include:
Wholesale products
Wholesale customers may be expected to purchase products in batches.
Food and catering
Certain food products may only be practical to sell in quantities such as 6, 12, or 24.
Promotional products
Branded merchandise may require a minimum production quantity.
Manufacturing
Manufacturers may only accept orders above a specific quantity.
Packaging
Boxes, labels, containers, and other supplies are frequently sold in bulk.
The requirement can therefore be part of the store's operational model rather than simply a website feature.
03
Wix's built-in checkout requirements
A major difference from the original version of this article is that Wix now provides a Checkout Requirements app that can handle several common rules without custom code. Wix currently supports:
Minimum product quantity
Maximum product quantity
Minimum order subtotal
Rules for specific products
Rules applied across products
Warning messages
Checkout blocking when requirements aren't met
For example, a store can create a rule requiring customers to purchase at least three units of a particular product. If the requirement isn't met, the merchant can choose whether to:
Show a warning and allow checkout
Prevent checkout until the requirement is met
04
When should you use Velo instead?
The built-in Checkout Requirements app is useful for standard requirements. But some businesses need more complicated rules. For example:
"Product A requires 10 units, Product B requires 25 units, but VIP customers can purchase smaller quantities."
"Minimum quantity changes depending on the customer's membership level."
"Show a custom popup explaining exactly how many additional units the customer needs."
These scenarios may require custom development. That's where Wix Velo can be useful.
05
How a custom MOQ system works
A custom Velo implementation can follow a simple process.
Step 1 — Store the MOQ
Each product can have an associated minimum quantity.
ProductMOQ
Product A10
Product B25
Product C50
Product D100
The values can be stored in a CMS collection or another appropriate data source.
Step 2 — Read the cart
When the customer reaches the cart, the system checks the products currently in the cart.
Step 3 — Compare quantity
The customer's quantity is compared with the product's MOQ. Customer quantity: 7 · Required quantity: 10. The system identifies that the requirement hasn't been met.
Step 4 — Display a message
The site can then show something like:
Cart message
Minimum order: 10 units. Please add 3 more units to continue.
Step 5 — Allow checkout
Once the requirement is satisfied, the customer can proceed. This approach was the central technical concept demonstrated in the original Brain Quest article.
Live MOQ example ↗Try the working Wix minimum order quantity demoWhy custom Velo development can be useful
Velo becomes particularly useful when your business rules go beyond a simple minimum number. A custom implementation can potentially support logic such as:
Customer-specific MOQs
Product-specific rules
Member-level pricing
Wholesale customer rules
Conditional quantity requirements
Custom cart messages
Custom validation
Integration with external systems
Dynamic business logic
The important distinction
Native Wix functionality handles standard rules. Velo is useful when the business logic becomes more specialized.
06
Example: wholesale store
Imagine a wholesale packaging business. Its rules might be:
ProductMinimum
Small Boxes50
Medium Boxes25
Large Boxes10
Custom Printed Boxes100
A standard checkout rule may work for some of these requirements. But if the company later wants different rules based on customer type, order history, location, or contract status, a custom Velo solution can provide more control.
07
What happens when a customer doesn't meet the MOQ?
The user experience matters just as much as the technical rule. Avoid displaying a vague error such as:
"Invalid quantity."
Instead, tell the customer exactly what they need to do. Better:
Better
This product has a minimum order quantity of 20 units. Please add 6 more units to continue.
Clear messages reduce confusion and make the ordering process easier.
08
MOQ vs minimum order value
These two concepts are different.
Minimum Order Quantity
The customer must purchase a certain number of units. Example: minimum 20 candles.
Minimum Order Value
The customer's total order must reach a specific monetary amount. Example: minimum order value of $100.
Wix currently supports minimum order subtotals as well as product quantity requirements.
Final thoughts
Minimum order quantities are an important part of many eCommerce business models.
If your requirement is straightforward, Wix's Checkout Requirements functionality may be enough.
If your store requires custom logic, dynamic validation, customer-specific rules, or more advanced workflows, Velo can extend the standard Wix eCommerce experience.
The right approach depends on how your business actually processes orders.
FAQ
Can Wix Stores have a minimum quantity requirement?
Yes. Wix's Checkout Requirements functionality can currently enforce minimum and maximum product quantities.
Can I set different minimum quantities for different products?
Yes. Checkout Requirements can be applied to specific products.
Can Velo create custom MOQ logic?
Velo can be used when your requirements go beyond standard checkout rules and require custom business logic.
Can Wix enforce a minimum order value?
Yes. Wix Stores supports minimum order subtotals.
Need MOQ rules standard checkout can't handle?
Customer-specific minimums, custom cart messages and validation built in Velo.
Start a project →