Gatemi Min/Max Quantities FAQ and Troubleshooting

Where do I set a rule?

  • Free edition: on the product, Product data → Inventory → Minimum quantity / Maximum quantity.
  • Full edition: on the product, Product data → General, under the Quantity rules heading; on each variation, by ticking Quantity rules; on a category, under Products → Categories; and for the whole order, on WooCommerce → Min/Max Quantities.

The quantity box ignores my minimum

Some themes and page builders draw their own quantity box instead of WooCommerce's. The plugin works through WooCommerce's quantity field (woocommerce_quantity_input_args); a custom box will not pick up the limits. The cart check still enforces the rule — the shopper is told before they can pay.

Why can a shopper add fewer than the minimum to the cart?

In the free edition the minimum is checked in the cart, not at add-to-cart, so the shopper can build up to it over several additions. They cannot check out until it is met. The full edition refuses an addition below the minimum, except on a product set to Combine variations, where the minimum is about the total and is checked in the cart.

Variations are added up together. Can each have its own limit?

Full edition: yes. Tick Quantity rules on the variation and fill in its numbers, and leave Combine variations off on the product. The free edition always uses the product's rule for all its variations together.

A category rule did not apply to a product

Full edition: check that the product does not have Ignore category rules ticked, and that it does not set the same number itself — a product's own value always wins. Remember that several categories combine generously: the lowest minimum and the highest maximum.

My numbers changed after saving

Full edition: a minimum is rounded up to the next multiple and a maximum down to the previous one, so the rule always describes a quantity somebody can buy. "At least 5, in multiples of 4" becomes "at least 8". The product screen says what was changed.

Does it work with the Cart and Checkout blocks?

Yes. The Cart block's quantity stepper takes its limits from the same quantity rules, and WooCommerce's cart check — which runs before the Store API places an order — enforces them. The full edition also reports problems as Store API cart errors and checks again when the order is placed.

Does it work with HPOS and page caching?

Yes. Both editions declare HPOS compatibility, and neither reads or writes orders. The product page markup is the same for every visitor; the checks happen on add-to-cart and in the cart, which are not cached.

Apple Pay or Google Pay buttons disappeared from a product

Full edition: express buttons are hidden only where a rule cannot be checked before the click — an order-wide rule, a combined-variations minimum, or a variable product with variation rules. The free edition does not touch express buttons.

I am moving from the free edition to the full edition

Install and activate the full edition; the free edition stands down while it is active. The two editions store product rules under different meta keys (free: _gmmqf_min, _gmmqf_max; full: _gmmq_min_qty, _gmmq_max_qty), so on the first admin page load after activation the full edition copies the free edition's minimum and maximum onto each product that has no rule of the full edition's own. Nothing you have already typed in the full edition is overwritten, and the free keys are left in place, so deactivating the full edition puts the free one back exactly as it was. Deleting the free edition once the full edition has been configured removes nothing.

I used WooCommerce Min/Max Quantities before

Full edition: the settings screen shows Existing quantity rules found with a count. Click Import rules: products, variations, categories and the order-wide values are copied, in batches. The old plugin's data is only read, so you can go back.

What does uninstalling remove?

  • Free edition: both of its product meta keys, _gmmqf_min and _gmmqf_max, on every product — unless the full edition has been configured on the site, in which case it removes nothing.
  • Full edition: always its settings, its cache counter, its licence state and cached update data. Product, variation and category rules are removed only if Delete all quantity rules when the plugin is deleted is on; otherwise they stay, so reinstalling picks up where you left off.

Neither edition writes anything to orders.

Shopping Cart
Scroll to Top