Role-Based Limits allow you to set specific purchase restrictions for different user roles in your WooCommerce store. This feature is useful when you want to enforce unique rules for customers, retail shoppers, subscribers, or any custom user roles you have defined.
How to Configure
Step 1: Navigate to Role Settings
- Go to WooCommerce > Min Max Quantities > Roles
- You’ll see a list of all available user roles in your store
- Click on the role you want to configure
Step 2: Enable Limits for the Role
Check the Enable limits checkbox to activate role-specific restrictions.
Step 3: Understanding Restriction Levels
Role-based restrictions are organized into three levels:
Product Limits – Control product-level purchases for this role
Cart Limits – Control order/cart totals for this role
Category Limits – Bypass all category-level purchase restrictions for this role
Each level can be configured independently based on your requirements.
Step 4: Configure Limits
Product Limits
Control how users with this role can purchase products.
Limits Type (Scope selection) – Choose the scope of product restrictions:
- Store-wide – Applies to all products.
- Specific Products – Apply rules only to selected products.
- Specific Categories – Apply rules to products in selected categories.
If you select Specific Products or Specific Categories, you must manually select the target products.
Available Settings:
- Minimum Quantity – Sets the minimum units this role must purchase per product
- Maximum Quantity – Sets the maximum units this role can purchase per product
- Minimum Total – Sets minimum monetary value this role must spend per product
- Maximum Total – Sets maximum monetary value this role can spend per product
- Quantity Step – Forces this role to purchase in specific increments (e.g., 3, 6, 9)
If you have variable products (in Specific Products), check Allow combination for variable products if needed. It controls how variation quantities are counted for variable products.
- Enabled: Maximum 10 = 10 items total (any variation mix)
- Disabled: Maximum 10 = 10 of each variation separately
Cart Limits
Control order/cart totals for users with this role.
Available Settings:
- Minimum Cart Quantity – Sets the minimum total number of items this role must have in cart
- Maximum Cart Quantity – Sets the maximum total number of items this role can have in cart
- Minimum Cart Total – Sets the minimum total order value this role must spend
- Maximum Cart Total – Sets the maximum total order value this role can spend
Category Limits
Allow this role to bypass all category-level purchase restrictions.
Available Settings:
- Ignore Category Limit (category limits don’t apply to this role)
Step 5: Save Changes
Click Save Changes to apply the role-specific limits.
Next Step
Now that you’ve configured role-based rules, you can revisit Product Variation-Level Limits for more granular control over product variations.