IntroductionQuick Start

Display Modes

Choosing a display modeBanner (Default)PopupCustom Display ModeAPI

Integrations

Display Modes

Banner (Default)

Customize the default discount banner — colors, top/bottom toggles, text template, countdown timers, and more.

The default display mode shows a banner bar at the top, bottom, or both edges 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.

Want a centered modal instead (or in addition)? See Popup.

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.

Top + bottom

The banner is split into two independent slots — top and bottom. Each has its own enable toggle and its own design settings, so you can:

  • Enable just the top banner (default).
  • Enable just the bottom banner.
  • Enable both simultaneously — handy if you want a sticky offer up top and a compact reminder pinned to the bottom.

Each slot is configured separately in Dashboard → Display → Top Banner and Dashboard → Display → Bottom 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 imageIndia flag
{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 per slot in Dashboard → Display → Top Banner / Bottom Banner:

OptionDescriptionDefault
Background colorBanner background#1a1a2e
Font colorText color#ffffff
Font sizeText size0.875rem
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 → Display → 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.

Popup

Centered modal with optional dim backdrop, configurable trigger (immediate, delay, exit-intent, scroll), and per-session or N-day dismiss behavior.

On this page

SetupTop + bottomText templateDesign optionsClick-to-copyPowered-by badgeCountdown timerTimer typesDisplay modesFormat optionsWhen the timer ends