Minimum Order Amount & Minimum Quantity for WooCommerce

By stickitsibiu

30+ active installationsVersion 1.3.3

Set a minimum order amount or minimum item quantity for WooCommerce checkout. Classic and block checkout, HPOS-ready, no jQuery.

Description

Small orders often cost more to pack and ship than they earn. This plugin sets a minimum order amount (minimum cart value) and/or a minimum number of items. Until the cart reaches your minimum, WooCommerce shows your message and does not let the customer place the order.

No code, no extra checkout plugin, no JavaScript on your store. One settings tab, the minimum you choose, and a message you write.

How it works

  1. Go to WooCommerce → Settings → Min Order.
  2. Set a minimum order amount, a minimum quantity, or both.
  3. If you set both, choose if the customer must meet one of them (OR) or both (AND).
  4. Write the message customers see when the cart is below the minimum.
  5. Customers below the minimum see the message on the cart and checkout pages and cannot complete the order.

Features

  • Minimum order amount based on the cart subtotal.
  • Minimum item quantity for the whole cart (all products added together).
  • AND / OR logic when you use both rules.
  • Your own message, in any language, with placeholders: {min_amount}, {min_qty}, {min}, {current} and {currency}.
  • Admins and shop managers are exempt, so you can place test orders and manage the store.
  • Classic and block checkout. The rule runs in WooCommerce cart validation and in the Store API, so it works with the classic shortcode checkout and with the Cart and Checkout blocks.
  • HPOS compatible (High-Performance Order Storage).
  • Lightweight. One small PHP file, no jQuery, nothing loaded on the front end.
  • Translation-ready, with a bundled .pot file.

Need help setting it up? https://cartmend.com/setup.html

Installation

  1. Install and activate the plugin (WooCommerce must be active).
  2. Go to WooCommerce → Settings → Min Order.
  3. Enable the rule, set a minimum amount and/or a minimum quantity, write your message, and save.
  4. Test in a private/incognito browser window — admins and shop managers are exempt by design, so testing while logged in as admin won’t show the block.

FAQ

Is the minimum checked on the subtotal or on the order total with shipping?

On the cart subtotal: the price of the products in the cart. Shipping costs and fees are not counted, and coupon discounts are not subtracted.

Does the minimum apply per product, or to the whole cart?

To the whole cart. The rule checks the cart subtotal and/or the total number of items across all products combined. It is not a per-product or per-category minimum.

Can I set a different minimum for some user roles, products or categories?

Not at the moment. There is one minimum for the whole store. The only automatic exemption is for store managers and administrators (anyone with the manage_woocommerce capability).

Does it stop the customer from checking out, or only show a warning?

It stops them. When the cart is below the minimum, WooCommerce shows your message as an error notice on the cart and checkout pages and refuses to complete the order until the cart qualifies — on both classic and block checkout.

Does it work with the WooCommerce block checkout (Cart and Checkout blocks)?

Yes. The rule is enforced through the WooCommerce Store API, which the Cart and Checkout blocks use, so the same minimum applies on classic and block checkout.

I set a minimum but I can still check out. Why?

You are probably logged in as an administrator or shop manager, who are exempt. Test in a private/incognito window as a guest or customer. Also check that the rule is enabled and saved.

Can I write my own message, in my language?

Yes. The message is a plain text field. Use {min_amount} and {min_qty} for your minimums, {current} for the current cart subtotal and {currency} for the currency symbol. On a multilingual store, translate the message the same way you translate other texts on that page.

Is it compatible with High-Performance Order Storage (HPOS)?

Yes. The plugin declares compatibility with HPOS.

Does it slow my store down?

No. It is a single small PHP file, adds no JavaScript or CSS to the front end, and only runs its check during cart and checkout validation.

Screenshots

Changelog

1.3.3

  • Added: {min}, {current} and {currency} placeholders in the custom error message, in addition to the existing {min_amount} and {min_qty}.
  • Added: proper translation loading (load_plugin_textdomain()) and a bundled languages/cartmend-minimum-order.pot.

1.3.2

  • Hardened settings saving (explicit nonce and capability verification).
  • Escaped all customer-facing notices.
  • The plugin now contains only the features listed on this page.

1.0.0

  • Initial release: minimum amount + quantity rules, AND/OR logic, custom message, classic + block checkout, admin exemption.