Min/Max Quantities makes it possible to:
- Define minimum and maximum quantity limits per product/variation, per product category or per order.
- Require specific products, or product categories, to be purchased in predefined multiples.
Installation
↑ Back to topTo start using a product from WooCommerce.com, you can use the โAdd to storeโ functionality on the order confirmation page or the My subscriptions section in your account.
- Navigate to My subscriptions.
- Find the Add to store button next to the product youโre planning to install.
- Follow the instructions on the screen, and the product will be automatically added to your store.
Alternative options and more information at:
Managing WooCommerce.com subscriptions.
Important: Min/Max Quantities requires WooCommerce 11.1+, PHP 7.4+ and WordPress 7.0+.
Configuration
↑ Back to topProduct rules
↑ Back to topTo configure quantity rules for a product:
- Edit the product.
- Navigate to the Product Data > General tab.
- Locate the Quantity Rules section.
- Configure the Minimum Quantity, Maximum Quantity, Group of, and Exclude from options.

- Minimum quantity: Set the minimum required quantity for this product per order.
- Maximum quantity: Set the maximum allowed quantity for this product per order.
- Group of: Enter a quantity to require this product to be purchased in multiples.
If you have defined order and category rules, you can tick the Exclude from checkboxes to skip individual products when evaluating order and category rules:
- Exclude from: Order rules: Exclude this product from order quantity and order value rules.
- Exclude from: Category rules: Exclude from all category quantity rules. When enabled, all category rules will be ignored. Product quantity rules will be used instead, if they are set.
When a quantity rule is set for a product, then the corresponding category quantity rule does not apply to this product.
For example, if a product belongs to a category with a Minimum Quantity rule and also has a product-level Minimum Quantity rule defined, then the product-level Minimum Quantity rule will be used.
Variable products
When editing a Variable product, an additional option appears under Product Data > General > Quantity Rules called Combine Variations.
- When this option is disabled, each variation will inherit the rules you have defined in the Quantity Rules section.
- When this option is enabled, the specified quantity rules are applied in the cart to all variations of this product.
For example, if a Maximum quantity of 5 has been set on the parent and Combine Variations is disabled, each variation can have no more than 5 units in the cart. If Combine Variations is enabled, the limit applies to all variations together: for example, 2 units of one variation and 3 of another reach the maximum of 5.
Variation rules
When Combine Variations is disabled, it is possible to define a different set of quantity rules for individual variations:
- Navigate to Product Data > Variations.
- Locate the variation you need to edit and expand its settings.
- Tick the Quantity rules box.
- Edit the Minimum quantity, Maximum quantity, Group of, and Exclude from fields.
- Save your changes.
When Combine Variations is enabled, the rules you have specified will be validated in the cart/checkout pages only.
Order rules
↑ Back to topIn addition to product-level rules, the extension allows you to set up minimum and maximum Order quantity and Order value rules in your WP Admin dashboard by navigating to WooCommerce > Settings > Products > General:

- Minimum Order Quantity: The minimum number of items required in an order.
- Maximum Order Quantity:ย The maximum number of items allowed in an order.
- Minimum Order Value: The minimum required order value, in your store’s base currency.
- Maximum Order Value: The maximum allowed order value, in your store’s base currency.
It is possible to exclude individual products from order quantity and value rules.
Category rules
↑ Back to topThe extension allows you to set Minimum, Maximum and Group of quantity rules for entire categories of products. Category-level rules are inherited by all products in the category, except for products that have been set as excluded. To create a category rule:
- Navigate to Products > Categories.
- Locate and edit a category.
- Enter a Minimum, Maximum or Group of value to require customers to purchase products from this category based on those rules.
- Save.
To exclude a product from all category quantity rules, edit the product and enable the Exclude from: Category rules option.
To exclude a product from some category quantity rules, edit the product and define product-level quantity rules.
For example, if a product belongs to a category with a Minimum Quantity rule and you would like to prevent this rule from applying to this product, edit the product and set a Minimum Quantity rule equal to 1.
Products that are not excluded from category quantity rules will inherit only the category-level quantity rules that do not have a corresponding product-level rule defined.
For example, if a product belongs to a category that has both Minimum and Maximum Quantity rules and the product has a product-level Minimum Quantity rule defined, then a) The product-level Minimum Quantity rule will be used, and b) The category Maximum Quantity rule will be used.
Developer resources
↑ Back to topDevelopers can use these guides to work with Min/Max Quantities:
REST API
↑ Back to topRead and update product and variation rules with the Min/Max Quantities REST API reference.
Custom code
↑ Back to topUse a filter to exclude selected products from order quantity and value totals.
FAQ
↑ Back to topIs it possible to import/export Min/Max Quantities rules?
It is only possible to export and import product level rules, by using WooCommerce’s built-in Import/Export tool. Before generating your CSV file, please ensure that Export Custom Meta? is checked.
When importing modified data, make sure that the values in the following columns are edited correctly:
- Meta: minimum_allowed_quantity โ Enter a whole number to set the minimum product quantity.
- Meta: maximum_allowed_quantity โ Enter a whole number to set the maximum product quantity.
- Meta: group_of_quantity โ Enter a whole number to set the productโs Group of rule.
- Meta: minmax_cart_exclude โ Enter yes or no to exclude the product from order quantity and value rules.
- Meta: minmax_category_group_of_exclude โ Enter yes or no to exclude the product from category Group of rules. A product with its own Group of rule is automatically excluded from the category Group of rule.
Questions and feedback
↑ Back to topHave a question before purchasing? Please fill out this pre-sales form.
Already purchased and need some assistance? Get in touch with a Happiness Engineer.
