IntroductionQuick Start

Display Modes

Choosing a display modeBanner (Default)Custom Display ModeAPI

Integrations

Display Modes

Banner (Default)

Customize the default discount banner — colors, position, text template, countdown timers, and more.

The default display mode shows a banner bar at the top or bottom of your page with the discount info. No code needed — just configure it in the dashboard.

Best for: Most sites. Drop a script tag, customize from the dashboard, done.

Setup

Add this before </body>:

<script src="https://www.evendeals.com/banner.js"></script>

That's it. The script detects the visitor's country, fetches the discount, and renders the banner.

Text template

The banner text supports these template variables:

VariableReplaced withExample
{country}Visitor's country nameIndia
{discount_amount}Discount percentage30%
{coupon_code}The coupon code (click-to-copy)PPP_IN_30
{country_flag}Country flag image🇮🇳
{timer}Countdown timer (if enabled)02:45:30

Default template:

{country_flag} It looks like you're visiting from {country}! Get {discount_amount} off with code {coupon_code}

Design options

Configure these in Dashboard → Banner Design:

OptionDescriptionDefault
Background colorBanner background#1a1a2e
Font colorText color#ffffff
Font sizeText size0.875rem
Positiontop or bottom of pagetop
StickyBanner stays visible on scrollfalse
Show close iconAdds an X button to dismisstrue
Container selectorPlace banner inside a specific element instead of bodybody
Show powered byEvendeals brandingPlan-dependent

Click-to-copy

The {coupon_code} variable renders as a clickable element. When visitors click it, the code is copied to their clipboard and a "Copied!" tooltip appears.

Powered-by badge

Free plans show a small "⚡ Evendeals" badge in the banner. Paid plans can hide it.


Countdown timer

Add urgency by showing a countdown in the banner. Configure in Dashboard → Banner Design → Timer.

Timer types

Fixed deadline — Set a specific date and time. All visitors see the same countdown. Use case: time-limited sales, product launches.

Evergreen (per visitor) — Each visitor gets their own timer starting from their first visit. Persists across page reloads. Use case: always-on urgency without a real deadline.

Changing the timer config in the dashboard automatically resets all visitors' timers.

Display modes

Inline — Renders inside the banner text wherever you place {timer}:

Get {discount_amount} off — offer ends in {timer}!

Result: Get 30% off — offer ends in 02:45:30!

Block — Renders as a separate block with large segmented digits next to the banner text. Labels (Days, Hours, etc.) appear below each segment.

Format options

FormatExample
dhms02:14:45:30
hms62:45:30
ms3765:30
human_readable2 days 14 hours 45 minutes 30 seconds
human_readable_short2d 14h 45m 30s

You can also customize the separator (default :), show labels, background color, and border radius of the timer block.

When the timer ends

BehaviorWhat happens
HideThe entire banner is removed from the page
FreezeTimer stops at 00:00:00, banner stays visible
Alternate textBanner text changes to a different message (supports the same template variables)

Choosing a display mode

Pick the right approach — banner, custom CSS, or API — based on your requirements.

Custom Display Mode

Show discounts in your own UI using CSS classes and the window object.

On this page

SetupText templateDesign optionsClick-to-copyPowered-by badgeCountdown timerTimer typesDisplay modesFormat optionsWhen the timer ends