Minimum and Maximum Order Quantity Per Product

Category: Orders  ·  Min plan: Free  ·  Slug: min-max-quantity

Set a minimum and maximum order quantity per product: how few and how many pieces of one product a single customer is allowed to order. Useful for wholesale sellers who only ship by the pack, and for anyone who wants to stop one buyer from clearing out a scarce product. Rules are set on a dedicated dashboard page and enforced when the order is submitted — on the storefront checkout, on fast checkout, and on landing pages.

Features

• Per-product min/max quantity rules
• Searchable, paginated product list page in your dashboard
• Inline save — no page reload
• Set 0 to keep min/max unlimited per product
• Promo offer bundles are exempt — merchant-set bundle qty is never blocked
• Custom form submissions are not affected
• Negligible impact on checkout speed
• Never blocks a real customer if something goes wrong internally

What it does

Activating the add-on adds a page at /dashboard/min-max-quantity listing your products — 30 per page, newest first, archived products excluded. Each row carries two fields: a Minimum and a Maximum for that product.

The values mean:

Value	Meaning
Minimum 0	No minimum — the customer may order a single piece
Minimum 3	The customer must order at least 3 pieces of that product
Maximum 0	No maximum — unlimited
Maximum 10	The customer cannot order more than 10 pieces of that product

Both fields accept whole numbers from 0 to 10000. A product with both fields at 0 has no rule at all, exactly like a product you never touched.

How it works

On the storefront. When a product carries a rule, its quantity picker is prepared for the customer: the quantity input starts at your minimum instead of 1, and the plus/minus stepper and direct typing stay inside the minimum and maximum you set. If the product page already caps quantity to available stock and that cap is tighter than your maximum, the stock cap wins.

At order submit. The real enforcement happens on the server the moment the order is sent. If the ordered quantity is below the minimum or above the maximum, the order is refused and the customer gets a clear message naming the product and the limit, written in your store's language (Arabic, French or English) — for example "You must order at least 3 unit(s) of ...".

What is skipped on purpose:

• Promo offer bundles. When the customer takes an offer whose quantity and price you configured yourself (buy 2 for 3000 DA), the rule is not applied — your bundle quantity is never blocked by your own min/max.
• Custom forms. A landing page custom form has no real product quantity, so nothing is checked.
• Products without a rule. Anything left at 0/0 is never touched.

warning

After changing a minimum or a maximum, the new value can take up to 10 minutes to appear on the public product page because of CDN caching. The protection on the server side applies immediately — an order that breaks the new rule is refused right away, even while the page still shows the old numbers.

Benefits

• Sell by the pack. Wholesale and semi-wholesale sellers can require a minimum of 3, 6 or 12 pieces per product instead of repeating it in the product description and hoping customers read it.
• Raise the average basket. A minimum of 2 on a low-margin product makes every order worth the delivery and the confirmation call.
• Protect scarce stock. A maximum stops one buyer (or one competitor) from taking your whole batch in a single order.
• Cap COD risk. Large cash-on-delivery orders are the ones that hurt most when refused at the door. A per-product maximum keeps each order inside a size you are comfortable shipping.
• No product-by-product editing. All the rules for your catalog live on one page, so you can review and change them in one pass instead of opening each product.

How to activate

1. Open Dashboard → Add-ons at /dashboard/addons.
2. Find Minimum & Maximum Quantity Per Product under Orders.
3. Click Activate — the add-on is available on the Free plan and on every plan above it.
4. A new sidebar entry for the add-on appears in your dashboard, pointing at /dashboard/min-max-quantity.

If you open the page before activating, it shows a short notice and a link back to the Add-ons page instead of the product list. See Add-ons overview for the full catalogue.

Using it

The page opens on four counters — Total products, Products with rules, With minimum, With maximum — so you can see at a glance how much of your catalogue is covered.

Under them, the product table:

• Search by product name or SKU with the search box at the top.
• Product column shows the product image, its name and its SKU.
• Price and Stock columns are read-only context, so you can decide the limits without opening the product. Products with stock tracking off show a dash instead of a number.
• Minimum and Maximum are the editable number fields. Values outside 0–10000 are corrected as you type.
• Save stays greyed out until you actually change something in that row. Click it and the rule is saved in place — the button reads Saving… then Saved, and the page never reloads.
• Use Previous / Next at the bottom to move through the catalogue, or search instead of paging.

tip

A maximum must be greater than or equal to the minimum, or 0 for no limit. Saving a maximum below the minimum is refused with a message on the Save button — otherwise the product would become impossible to order at all.

To remove a rule completely, set both Minimum and Maximum back to 0 and save.

FAQ

What does 0 mean exactly? 0 means "no limit on this side". Minimum 0 lets the customer order a single piece; maximum 0 means unlimited. Both at 0 = the product has no rule.

Will this block my promo offers and bundles? No. When the customer buys through an offer you configured (a fixed bundle quantity and price), the min/max rule is deliberately skipped, so your own bundles are never rejected.

Does it apply to landing pages and fast checkout too? Yes. The check runs when the order is submitted, so it covers the normal storefront checkout, fast checkout and landing pages alike. Orders refused this way never reach your Orders page.

I changed the minimum but the product page still shows the old one. That is the CDN cache — allow up to 10 minutes for the public page to refresh. Enforcement on submitted orders is already using the new value.