Common issues and their solutions.
Rules Not Applying
| Possible Cause | Solution |
|---|
| Rule is disabled | Check the rule status is "Active" |
| Conditions not met | Review conditions and match mode (ALL vs ANY) |
| Rule conflicts | Check exclusivity settings of other rules |
| Cart not updated | Trigger a cart recalculation (add/remove an item) |
BOGO Items Not Appearing
| Possible Cause | Solution |
|---|
| Purchase quantity not met | Verify bogo_purchase_quantity vs actual cart quantity |
| Receive candidates empty | Check bogo_products or bogo_product_categories settings |
| Condition mismatch | Ensure the rule's conditions match cart items |
Automations Not Running
| Possible Cause | Solution |
|---|
| Automation is disabled | Enable the automation |
| Action Scheduler backlog | Check WooCommerce → Status → Scheduled Actions |
| Conditions not met | Review automation run history for "conditions_not_met" |
| Capability check | Verify the user has manage_woocommerce permissions |
| Recommendation | Details |
|---|
| Limit active rules | Each rule adds evaluation overhead per cart item |
| Use DB optimization | PredictCart adds database indexes on activation |
| Enable caching | Cart rule results are cached to reduce computation |
| Review complexity | Rules with many conditions are slower to evaluate |
Getting Support
For additional support, visit the support portal.