Configuration
Minimum is configured entirely from WooCommerce → Minimum. You build one or more rules, each scoped to the whole store, a category, or a specific product, plus an optional store-wide minimum order total and the notices shoppers see.
Rule scope
Section titled “Rule scope”Each rule applies at one of three levels:
- Global — the default rule for every product.
- Category — applies to products in a chosen category.
- Product — applies to one specific product.
You can have rules at more than one level at once. How they interact is covered under How rules combine.
The quantity constraints
Section titled “The quantity constraints”Each rule can set any combination of:
- Minimum — require at least N units of the product before checkout. Leave at 0 to ignore.
- Maximum — cap how many units a customer can buy. Leave at 0 to ignore.
- Step — force purchases in multiples, for example packs of 6 (a step of 6 allows 6, 12, 18 …). Leave at 0 to ignore.
A field left at 0 is ignored, so you can set just a minimum, just a step, or any mix.
Minimum order total
Section titled “Minimum order total”A separate, store-wide constraint: require the cart subtotal to reach a minimum before checkout is allowed. This is independent of the per-product quantity rules — useful for setting a floor on small orders regardless of which products are in the cart.
Custom notices
Section titled “Custom notices”Each unmet rule shows a notice you control. The messages are editable on the settings screen and support replacement tokens so the text always names the specific product and value:
{min}— the required minimum quantity.{max}— the maximum quantity allowed.{step}— the required multiple.{product}— the product name.{total}— the required minimum order total.
For example, a minimum notice of You must order at least {min} of {product}. renders with the real numbers and product name when the rule is unmet.
How rules combine
Section titled “How rules combine”For each constraint (min, max, step) the most specific matching rule wins, evaluated independently:
- A product rule beats
- a category rule, which beats
- the global rule.
Because each constraint resolves separately, a product can take its minimum from a product rule while taking its step from a category rule, if that is how your rules are arranged. The minimum order total is always evaluated against the cart subtotal, separately from the quantity rules.
Where rules are enforced
Section titled “Where rules are enforced”Validation runs at three points, so a rule cannot be slipped past:
- On add-to-cart — adding a quantity that breaks a rule is caught immediately.
- In the cart — adjusting quantities is re-validated.
- At checkout — a final check blocks checkout until every rule is satisfied.
This covers both the classic and the block-based cart and checkout, since rules are evaluated against the cart itself rather than legacy WooCommerce internals.
Compatibility and housekeeping
Section titled “Compatibility and housekeeping”Minimum is HPOS (Custom Order Tables) and Cart/Checkout Blocks compatible, self-contained with no third-party runtime dependencies, and ships with an accessible, dark-mode-aware admin screen with inline help. It creates no custom database tables; deleting the plugin removes the minimum_settings and minimum_db_version options and leaves your database exactly as it was.