Minimum order quantity for a customer

Set a minimum total quantity per order for an individual customer, or a minimum quantity for selected products. The shop refuses orders below the limit.

⏱ 6 minAdvancedUpdated 8 Oct 2026

In wholesale, it is not worth sending a single item. For each customer you can set a minimum total quantity of items per order, and on top of that a minimum quantity for individual products. The limit only applies to the customer it is set for; other customers and guests order without limits.

The shop checks the quantities when the customer clicks the button to place the order at checkout, not earlier in the cart. Until then, the customer can put less than the allowed amount in the cart without any warning.

1. Switching it on

Stores › Configuration › Magelan › Minimum Quantity Settings

  1. In the General Configuration section, set Enable Minimum Quantity Check to Yes.

    Minimum quantity general settings with the switch and the two messages
    1. Enable Minimum Quantity Check - Yes.
    2. Error Message - text with %1 and %2.
    3. Message on the cart page - currently not shown.
  2. In Error Message, enter the text the customer sees when the total quantity is too low. Use %1 for the required quantity and %2 for the current quantity, for example: The minimum order for your account is %1 items; you have %2 in your cart. If you leave the field empty, the customer sees the default message: Minimum order quantity for your account is %1. Current quantity is %2.

  3. You can leave the Message on the cart page field empty; it is currently not shown in the shop.

  4. Click Save Config.

The note below the field says you can use {{min_qty}} and {{current_qty}}. These are not replaced with numbers in the message; use %1 and %2 instead.

2. Total quantity for a customer

Customers › All Customers › (customer) › Account Information

In the Minimum Order Quantity field, enter the minimum number of items per order (for example 50). The total of all product quantities in the cart is counted. An empty field or 0 means no limit. Click Save Customer.

The Minimum Order Quantity field on the customer
Minimum Order Quantity - total number of items per order for this customer.

3. Quantity for individual products

Customers › All Customers › (customer) › Product Minimum Quantity

  1. The tab shows a list of all products. Find the product (by name or SKU) and tick it.

  2. In the Minimum Qty column, enter the minimum number of items the customer must order.

    The Product Minimum Quantity tab: product list with a ticked product and an entered quantity
    1. The tick marks the product the limit applies to.
    2. Minimum Qty - number of items for this product.
  3. Repeat for other products and click Save Customer.

On the page of such a product, the customer sees a red note Minimum quantity for this product: 10. If they order fewer at checkout, they get the message The minimum quantity for product (name) is 10.

If you have several customers with the same terms, write to us. We can set their limits in one step, so you do not have to open each one.

What the customer sees

The cart and checkout look as usual. When the customer clicks the button to place the order, the shop checks the quantities; if they are below the limit, the order is not placed and your message is shown. The customer goes back to the cart, corrects the quantities and tries again.

Common problems

A customer with a limit can still place a smaller order

Check that the check is switched on for the right store view (top left, next to Scope:) and that the customer was logged in when ordering. The limit does not apply to guests.

The message shows {{min_qty}} instead of a number

Replace it with %1 and %2, as described above.

The Product Minimum Quantity tab is missing on the customer

The tab appears on existing customers, not when creating a new one. Save the customer first and open them again.

Was this article helpful?

Related