Banners

Banners are notification-style engagement elements that appear on your website to inform visitors about new features, updates or important announcements. They can be triggered by a range of events and conditions, and support rich customization including different display styles, backgrounds, borders and interactive actions.

How Banners Work

Banners are displayed directly on your website when trigger conditions are met. They integrate with your site's design and can include text content, styling options, and interactive elements like buttons or a close control.

The banner list opens as a table with one row per banner. Two buttons at the top right of the list switch between List view and Card view; Yaplet remembers your choice in this browser.

Above the list, a strip of numbers shows how many banners are Live (out of the total) and how many are Drafts, plus three figures for the last 30 days: Shown · 30 days, Clicked · 30 days and the Engagement rate, which is all clicks divided by all times shown across every banner. Under the strip, the All, Live and Draft buttons (each with a count) narrow the list by state. You can also search by name, filter by widget and sort by name, priority or creation date.

Each row shows:

  • Up and down arrows that set the banner's priority — hover them for Increase priority and Decrease priority
  • A small color tile, the banner name and the first line of its text
  • A switch with a Live or Draft badge — flip the switch to put the banner live or turn it off, right from the list
  • The widget the banner belongs to
  • Shown, Clicked and Rate for the last 30 days — hover a column heading to see the period
  • The creation date
  • A Reports button and an Edit button, plus the ⋯ menu with Edit, Reports, Duplicate and Delete

In Card view each banner is a card instead: a live color preview strip, the name, the widget, a Live or Draft badge you can click to switch the state, the creation date and a one-line performance summary for the last 30 days (a banner nobody saw in that period says so instead of showing zeros). The card footer has the Priority number with its two arrow buttons, a Reports shortcut and an Edit button, with Copy and Delete behind the ⋯ menu.

Creating a Banner

Click New Banner to open the creation modal. You can start from scratch or choose a pre-built template:

Blank Banner

Start with an empty banner and build it your way.

Server Issue

Yellow inline banner with a "Contact us" chat action. Fires on every page view.

New Feature

Blue inline banner with a "Learn more" URL action. Fires at session start, once per visitor.

Special Offer

Green inline banner with a "Claim offer" URL action. Fires at session start, once per visitor.

Important Notice

Red inline banner with no close button and no action. Fires on every page view.

Info Tip

Indigo inline banner with a "Show me" URL action. Fires at session start, once per visitor.

Templates pre-fill both the visual settings and the trigger conditions, giving you a ready-to-use banner that you can customize further.

The banner editor uses a two-panel layout on desktop: a settings panel on the left and a live preview on the right. On mobile, the preview appears as a sticky strip at the top with the full settings form below.

The title bar has a back arrow to the banner list, a Reports button and the save controls. As soon as you change something, Unsaved changes appears with Discard and Save changes; with nothing to save it reads Saved. If you leave the page with unsaved edits, Yaplet asks first. Whether the banner is live is the Published switch under General.

The settings panel is split into icon-led sections, in this order — General, Trigger, Content, Background, Layout, Border and Action — so each group of fields is visually separated and easier to scan.

Triggering Banners

The Trigger section sits directly under General. If no triggers are configured it shows a warning box reading "No triggers configured — This banner won't show to any visitors." If triggers exist, it shows how many conditions are set. Clicking either opens the trigger configuration modal.

For detailed information about configuring triggers, see our comprehensive trigger documentation.

Trigger Configuration

Learn about all available trigger options and how to configure them for your banners.

General

Name
string required
A descriptive title for your banner, used in the dashboard.
Widget
string required
Which chat widget this banner belongs to — and therefore which website it appears on. A brand has at most one chat widget, so in practice you are choosing the brand.
Published
boolean
Whether the banner is active and can be displayed to visitors.

Content

Content
string required
The main text content of your banner, supporting HTML formatting through a rich text editor.

Background

The Background section starts with a Solid and Gradient tab switcher. Pick a mode, and only the fields relevant to that mode appear below.

A single background color for the banner.

Color
string
The banner's background color.

:: :::

A multi-stop linear gradient. Each stop is a color, blended in order along the chosen angle.

Stop 1 … Stop N
string
Between 2 and 5 color stops. Add a stop with the Add stop button; remove a stop with the × next to it (the minimum of 2 stops is enforced — you can't drop below it).
Angle
number
Rotation angle in degrees (0–360). Edit it via the number input, drag the slider, or click one of the 0° / 90° / 180° / 270° / 360° preset markers underneath the slider.

::

Switching back to Solid keeps your gradient stops, so you can flip between modes without losing your color choices. The text color automatically adjusts based on the middle color of the gradient for optimal contrast.

Layout

Style
select required
Choose where the banner sits on the page and how it behaves when visitors scroll (see Display Styles below). A short hint under the options explains the one you picked.
Corner radius
number
Only shown when Style is set to Floating pill — how rounded the corners are, in pixels (leave empty for the default).
Show a close button
boolean
Lets visitors dismiss the banner with an × in the top-right corner.

Display Styles

Banners offer three different display styles, each with its own positioning and behavior:

Full-width banners that are appended to the top of the body tag. They push down any element that is not fixed to the screen and scroll with the page content - disappearing when scrolled, just like regular page elements.

When active, the body tag receives the yaplet-b-shown CSS class.

Banners automatically add CSS classes and CSS variables to your page when displayed, allowing you to adjust your layout if needed. Use these to customize how your site's elements interact with the banner positioning.

Border

Show border
boolean
Adds an outline around the banner. Width and color fields appear once enabled.
Border Width
number
Border thickness in pixels.
Border Color
string
Outline color.

Action

The When clicked option cards set what happens when a visitor clicks the banner's link. A short hint under the cards explains the one you picked.

No action

The banner only shows its text. Clicking it does nothing.

Start conversation

Opens the chat with a new conversation. You can optionally pick a workflow to run in it (Optionally select a workflow to start) — the picker lists the chosen widget's active custom workflows, and None leaves the conversation to start empty.

Start survey

Opens one of this widget's published surveys. Pick it in the Start survey list.

Show feedback form

Opens one of your ticket forms, so visitors can send feedback. Pick it in the Show feedback form list. Forms live on the board they file tickets on — Conversations → Tickets → (board) → Forms.

Open URL

Opens a web address in a new browser tab. Type it into URL to open.

Show knowledgebase article

Opens an article from this widget's help center — a published article from whichever knowledge base is currently live at the brand's web address, the one you picked with the Show at … action on Brand → (your brand) → Knowledge. That action names your own address once the brand has one, and reads Show at your web address until then. Pick the article in the Select article list.

Show news article

Opens one of this widget's published news posts. Pick it in the Select news list.

Every action except No action also shows two fields for the link itself:

Link text
string
The underlined link at the end of the banner's text, for example Learn more.
Link color
string
Custom color for the link. Leave it empty to use the default color, or press Reset to go back to it.
Unless you set a Link color, the link uses the banner's text color — which already adjusts for contrast based on your background choice.

Preview & Testing

The live preview in the editor shows how your banner will look on your website. On desktop, it's displayed in a browser mockup alongside the settings panel. Under the mockup, the Page background color swatch lets you change the background of the pretend page, to test different page backgrounds and make sure the contrast holds.

Testing engagement campaigns

Learn how to safely test your campaigns before letting them reach live visitors.

Always test your banners across different devices and screen sizes, especially when using floating styles or gradients, to ensure they display correctly for all visitors.

© 2026 Yaplet. All rights reserved.