Introduction #
If your Cart Discount is not applying as expected, the issue is usually related to one of the following:
- Eligibility Rules are failing
- Minimum requirements have not been met
- The promotion is inactive
- Schedule dates are restricting the promotion
- Customer conditions are not satisfied
- Purchase History conditions are not satisfied
- Another promotion is taking priority
This guide will help you identify the most common causes and resolve them quickly.
How Cart Discounts Work #
Unlike product discounts, Cart Discounts do not target specific products.
Instead, Cart Discounts evaluate the cart, customer, and store conditions before applying a discount to the entire cart.
Before a Cart Discount can apply, all of the following must be true:
✓ Promotion is Active
✓ Schedule is valid
✓ Eligibility Rules pass
✓ Usage limits have not been reached
✓ Promotion priority allows the discount
If any requirement fails, the Cart Discount will not apply.
Quick Checklist #
Before continuing, verify:
- Promotion status is Active
- Cart meets all eligibility requirements
- Customer meets all customer conditions
- Purchase History conditions pass
- Schedule dates are valid
- Usage limits have not been reached
- No higher-priority promotion is overriding the discount
Cause 1: Promotion Is Not Active #
Problem:
The Cart Discount promotion is inactive, disabled, or saved as a draft.
Solution:
Verify that the promotion status is set to Active.
Result:
Active promotions become eligible for evaluation.
Cause 2: Cart Subtotal Requirement Is Not Met #
Cart Discounts are commonly based on minimum spend requirements.
Problem:
The customer has not reached the required cart subtotal.
Example:
Condition:
Cart Subtotal greater than or equal to $100
Current Cart:
$75
Result:
The Cart Discount does not apply.
Solution:
Increase the cart subtotal until the requirement is met.
Cause 3: Cart Item Count Requirement Is Not Met #
Some Cart Discounts require a minimum number of products.
Problem:
The customer has not added enough items to the cart.
Example:
Condition:
Cart Item Count greater than or equal to 5
Current Cart:
3 items
Result:
The Cart Discount does not apply.
Solution:
Add additional products to the cart.
Cause 4: Cart Weight Requirement Is Not Met #
The promotion may require a specific total cart weight.
Problem:
The cart weight falls outside the configured requirement.
Example:
Condition:
Cart Weight greater than 10 kg
Current Cart Weight:
6 kg
Result:
The Cart Discount does not apply.
Solution:
Verify the total cart weight and condition configuration.
Cause 5: Coupon Conditions Are Failing #
Cart Discounts can evaluate coupon usage.
Problem:
Required coupons have not been applied.
Example:
Condition:
Applied Coupon = VIP20
Current Cart:
No coupon applied
Result:
The Cart Discount does not apply.
Solution:
Apply the required coupon or adjust the coupon conditions.
Cause 6: Payment Method Condition Is Failing #
The promotion may require a specific payment method.
Problem:
The selected payment method does not match the configured condition.
Example:
Condition:
Payment Method = Bank Transfer
Current Payment Method:
Stripe
Result:
The Cart Discount does not apply.
Solution:
Select the required payment method or update the promotion conditions.
Cause 7: Customer Conditions Are Not Passing #
The promotion may be restricted to specific customer groups.
Problem:
The customer does not satisfy the configured Customer Conditions.
Example:
Condition:
Customer Role = VIP
Current Customer:
Standard Customer
Result:
The Cart Discount does not apply.
Solution:
Review all Customer Conditions configured on the promotion.
Cause 8: Purchase History Conditions Are Not Passing #
The promotion may require previous customer activity.
Problem:
The customer does not meet the configured purchase history requirements.
Example:
Condition:
Order Count greater than or equal to 5
Customer Order Count:
2
Result:
The Cart Discount does not apply.
Solution:
Review all Purchase History Conditions configured on the promotion.
Cause 9: Shop Conditions Are Not Passing #
The promotion may only run during specific dates or times.
Problem:
The current date or time falls outside the configured conditions.
Example:
Condition:
Current Date between November 25 and November 30
Current Date:
December 10
Result:
The Cart Discount does not apply.
Solution:
Verify all Shop Conditions and promotion schedules.
Cause 10: Promotion Schedule Is Restricting The Promotion #
Promotions can have optional start and end dates.
Problem:
The promotion is outside its active schedule.
Example:
Promotion Start Date:
December 1
Current Date:
November 20
Result:
The promotion is inactive.
Solution:
Review the promotion schedule configuration.
Cause 11: Usage Limits Have Been Reached #
Promotions can stop applying after reaching configured limits.
Problem:
The promotion has reached its maximum usage count.
Result:
The promotion is no longer eligible.
Solution:
Increase the usage limit or reset the campaign.
Cause 12: Another Promotion Is Taking Priority #
Multiple promotions may match the same cart.
Depending on your settings, another promotion may be selected instead.
Problem:
A higher-priority promotion is overriding the Cart Discount.
Solution:
Review:
- Promotion Priority
- Cart Discount Strategy
- Other active promotions
Result:
The intended promotion can be evaluated correctly.
Cause 13: Ezhance Pro Is Required #
Cart Discounts are a Ezhance Pro feature.
Problem:
The store is using Ezhance Free.
Solution:
Install and activate Ezhance Pro.
Result:
Cart Discounts become available.
Common Scenarios #
Cart Discount Never Applies #
Check:
- Promotion status
- Eligibility Rules
- Schedule dates
- Usage limits
Cart Discount Works For Some Customers But Not Others #
Check:
- Customer Conditions
- Purchase History Conditions
- Customer Roles
Cart Discount Worked Previously But Stopped #
Check:
- Promotion schedule
- Usage limits
- Recent promotion changes
Cart Discount Applies Incorrectly #
Check:
- Discount amount
- Cart Discount strategy
- Other active promotions
Best Practices #
Start With Simple Conditions #
Create a basic Cart Discount and verify it works before adding advanced rules.
Test Conditions Individually #
Add one condition at a time and verify the expected result.
Review Customer-Based Conditions Carefully #
Customer and Purchase History conditions are common causes of failed promotions.
Verify Promotion Priority #
When multiple promotions exist, always check how they interact.
