Table of Contents
Problem Description #
Store owners experience various unexpected behavior (limits not applying, conflicts, misconfiguration) and lack a systematic troubleshooting approach.
Checklist for diagnosing issues #
- Verify plugin version & compatibility, ensure plugin version is up-to-date and tested with your WooCommerce and WordPress versions. WordPress.org+1
- Double-check configuration, correct mode (quantity, orders, price, etc.), timeframe, order statuses, user roles, product/category vs global limits. WPFactory+1
- Test with minimal setup, switch to a default theme and disable other plugins to rule out conflicts.
- Clear cache and transients, some caching plugins may cache cart/order state causing outdated limit enforcement.
- Use test accounts for each relevant user role to verify per-role limits or per-user custom limits.
- Use formula/shortcode carefully when using per-user or per-product custom limits; document them externally for maintainability.
- Test time-based limits across periods, ensure limits reset correctly; double check server timezone, WP timezone, and correct order statuses.
- Have backup & staging environment, especially before plugin updates, to avoid breaking checkout or site.
