Introduction #
Ezhance can display promotional information throughout your store using components such as:
- Offer Cards
- Tier Pricing Tables
- Countdown Timers
- Progress Messages
- Savings Messages
- BOGO Reward Cards
If a display component is not appearing, the issue is usually related to promotion eligibility, targeting, display settings, or theme compatibility.
This guide walks through the most common causes.
Quick Checklist #
Before troubleshooting, verify:
✓ Promotion is Active
✓ Product matches Target Selection
✓ Eligibility Rules pass
✓ Display component is enabled
✓ Promotion schedule is active
✓ Ezhance Pro is installed (if required)
Cause 1: Promotion Is Not Active #
Inactive promotions do not display storefront components.
Problem:
The promotion is saved as Draft or Disabled.
Solution:
Activate the promotion and test again.
Cause 2: Product Does Not Match Target Selection #
Display components only appear for targeted products.
Problem:
The product is not included in the promotion targets.
Example:
Target:
- Hoodies
Current Product:
- T-Shirt
Result:
No display appears.
Solution:
Verify Target Selection settings.
Cause 3: Eligibility Rules Are Failing #
Many storefront displays only appear when the promotion is eligible.
Problem:
A configured condition is failing.
Example:
Condition:
Cart Subtotal greater than $100
Current Cart:
$50
Result:
The display does not appear.
Solution:
Review all Eligibility Rules.
Cause 4: Display Component Is Disabled #
The display may not be enabled for the promotion.
Problem:
Offer Card, Tier Pricing Table, or Countdown Timer is disabled.
Solution:
Open the promotion and verify the display component is enabled.
Cause 5: Countdown Timer Has No End Date #
Countdown Timers require a valid end date.
Problem:
No promotion end date exists.
Result:
The timer cannot be displayed.
Solution:
Configure an end date for the promotion.
Cause 6: Bulk Discount Quantity Requirements Are Not Met #
Tier Pricing Tables are typically connected to Bulk Discounts.
Problem:
The discount configuration is incomplete or invalid.
Solution:
Verify:
- Quantity tiers
- Discount values
- Bulk Discount settings
Cause 7: Ezhance Pro Is Required #
Some display components are only available in Ezhance Pro.
Examples:
- Countdown Timer
- Progress Message Card
- Savings Message
- BOGO Reward Card
Solution:
Verify that Ezhance Pro is installed and activated.
Cause 8: Another Plugin or Theme Is Hiding The Display #
In rare cases, themes or optimization plugins may prevent storefront elements from rendering correctly.
Problem:
The promotion is active but nothing appears on the page.
Solution:
Temporarily test with:
- Default WooCommerce theme
- Plugin conflict testing
If the display appears, a theme or plugin conflict may exist.
Cause 9: Display Position Is Incorrect #
The display may be rendering in a location that is not visible.
Problem:
Display position configuration is incorrect for the active theme.
Solution:
Try alternative display positions and retest.
Common Scenarios #
Offer Card Not Showing #
Check:
- Promotion status
- Target Selection
- Display enabled
- Eligibility Rules
Tier Pricing Table Not Showing #
Check:
- Bulk Discount configuration
- Quantity tiers
- Product targeting
- Display enabled
Countdown Timer Not Showing #
Check:
- Countdown enabled
- Promotion end date
- Ezhance Pro active
- Promotion eligibility
Multiple Displays Missing #
Check:
- Promotion status
- Theme conflicts
- Display positions
Best Practices #
Test With Minimal Conditions #
Start with a simple active promotion and verify the display appears.
Verify Product Targeting First #
Most display issues are caused by products not matching the promotion.
Configure End Dates For Timers #
Countdown Timers should always have a valid end date.
Test On A Product Included In The Promotion #
Displays only appear where the promotion is applicable.
