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.
Banner List
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.
Banner Editor
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.
Banner Settings
General
Content
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.
:: :::
A multi-stop linear gradient. Each stop is a color, blended in order along the chosen angle.
::
Layout
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.
Full-width banners that stick to the top of the screen even when scrolling. This style doesn't attempt to push down page content - it appears on top of existing elements. Perfect for sites with fixed navigation bars or headers.
Adds yaplet-b-shown and yaplet-b-fi CSS classes to the body. If needed, you can push down fixed headers using the --yaplet-margin-top CSS variable.
Centered, pill-shaped banners that don't span the full screen width. Like floating full width, they stick to the top but are visually distinct and slightly distanced from the screen edge.
Adds yaplet-b-shown and yaplet-b-f CSS classes to the body. If needed, you can push down fixed headers using the --yaplet-margin-top CSS variable.
Border
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.
Link text and color
Every action except No action also shows two fields for the link itself:
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.