User Documentation

What Plugin Does

Plugin limits how many units customer can buy for selected products. Use it when products must ship in fixed packs or exact sample sets.

Create Rule

1. Open WooCommerce -> Quantity Rules.
2. Start with template or add blank rule.
3. Choose rule type:
   • Multiple: customer must buy in pack multiples
   • Exact Set: customer must choose from fixed allowed quantities
4. Set scope with one or more of:
   • product IDs
   • category IDs
   • shipping class IDs
   • roles, including guest
5. Save rules.

Import and Export

• Export box shows current rules as JSON
• Import box accepts JSON array or object with rules array
• Imported rules are sanitized before save

Customer Experience

• Product page can adjust quantity step and minimum values
• Product page displays short hint text
• Invalid quantities are blocked in:
  • add to cart
  • cart quantity updates
  • cart review
  • checkout
• Error notices can include nearby valid quantity suggestions

Tips

• Use lower priority number for rule that should win first
• Use exact sets for sample packs or fixed bundle counts
• Include guest role when rule should apply before login

Known Limits

• Plugin does not provide bulk CSV tools
• Plugin does not add per-product edit panels; rule management is centralized
• Plugin keeps stored rules on deactivation and there is no uninstall cleanup flow in repo