Ezhance
← Documentation

Why Isn't My Promotion Applying?

Step-by-step checklist for diagnosing why an Ezhance promotion is not applying to products or the cart.

If a promotion isn't applying, work through this checklist in order. Ezhance evaluates promotions sequentially — if any step fails, the promotion won't apply.

Checklist

1. Verify the promotion is Active

Go to Ezhance → Promotions and confirm the promotion status is set to Active, not Draft.

2. Check the schedule dates

If you've set a start date in the future, the promotion won't apply yet. If the end date has passed, the promotion has expired. Verify both dates are correct for today.

3. Check usage limits

If the promotion has a Maximum Usage Count, check whether that limit has been reached. Promotions stop applying once the limit is hit.

4. Verify target selection

Confirm the product you're testing matches the configured target rules. If you've excluded specific products or categories, a product may be unintentionally excluded.

5. Check eligibility rules

If you've added eligibility rules (cart subtotal, customer role, etc.), verify your test scenario meets all of them. Temporarily remove all rules to confirm the promotion applies without them, then add rules back one by one.

6. Check include/exclude rules

Exclusion rules always override inclusion rules. A product that matches an exclusion rule will never receive the promotion, even if it matches an inclusion rule.

7. Verify Pro features are available

These features require Ezhance Pro:

  • Cart Discounts
  • Buy X Get X / Buy X Get Y
  • Order Coupons
  • Product category, tag, and attribute targeting
  • Customer, purchase history, billing, shipping, and shop conditions
  • Countdown timers

8. Check promotion priority

When multiple promotions target the same product, the Product Discount Strategy in Ezhance → Settings determines which applies. If the strategy is "Biggest Discount," a higher-priority promotion with a larger discount may be overriding yours.

9. Check sale item exclusions

If the promotion uses "Exclude Sale Items" targeting, products with an active WooCommerce sale price will be excluded.

10. Check BOGO quantity requirements

For Buy X Get X and Buy X Get Y promotions, the customer must have the qualifying quantity in their cart before the reward applies.

11. Check Cart Discount rules

Cart Discounts do not use Target Selection. They evaluate only Eligibility Rules. If no eligibility rules are passing, the cart discount won't apply.

12. Check Order Coupon requirements

Order Coupons only generate after an order is completed. They do not appear during browsing, cart, or checkout.

Common Mistakes

  • Leaving the promotion in Draft status
  • Setting a start date in the future by accident
  • Confusing Target Selection (which products) with Eligibility Rules (which customers)
  • Testing Pro features without Ezhance Pro installed