Getting Started
Configure the Yaplet chat widget for the first time, and learn which tab of the widget designer holds each setting.
First-Time Configuration
Everything below happens in the widget designer, which you open from Brand → Chat widget. The designer is split into seven tabs — Style, Home screen, Chat, Widget tabs, Languages, Install and General — with a live preview beside them. Nothing you change is applied to your website until you press Save changes.
Set your brand colors
On the Style tab, the Brand & colors group asks for a Widget color, one to three Brand colors, and whether they run on Buttons & messages as one color or a gradient. Each brand color has a ⋯ menu ("Move or remove this color") with Move up, Move down and Remove, and Add a color adds the next one (three is the maximum). Everything else is calculated from them and checked for readability, so there is nothing to generate or fine-tune. Starting points, in the section's header, applies one of twelve finished looks if you would rather pick than choose. The preview updates as you go. See Color System for what each choice does.
Or let AI do the first pass
Still on Style, the Redesign with AI button in the section's header asks for a website address, reads it, and proposes a whole design to match — colors, Home screen background, corners, card style and launcher look — plus quick buttons about your business. The result lands in the form and the preview only — nothing is written to your live widget until you press Save changes, so you can look first and discard it by leaving the page. AI setup is paid for like other AI work: from your free 14 days, your bought credit or your plan. A preview you never save still counts, and if nobody can pay, the button opens the payment window and nothing runs.
Choose your logo and widget icon
On Style, the first two rows of the Brand & colors group are the Logo (shown at the top of the home screen) and the Widget icon (shown to your team next to this widget in the inbox and the mobile app — visitors always see Yaplet). Both open Your images, the shared image library for your whole organization — pick an image that is already there, or upload a new one and it stays available everywhere next time. See Branding, Menu & Dark Mode.
Write the greeting
Go to the Home screen tab, Home Screen Settings. This is where the header greeting, the welcome message and the "show team avatars" switch live. Write the texts in your own language; the other languages are behind the globe button next to each field. Learn about all the options in Greeting, Welcome & Team Display.
Choose the Home screen background
Back on Style, the Home background group builds what sits behind the greeting out of four layers you can mix freely — Color, Photo, Glow and Lines — with Reaches for how far down they go. The Cards and Corners rows, in the Shape & finish group above it, set the shape of everything. See Home Screen Background for what each option draws.
Configure home screen cards
On the Home screen tab, Home Cards decides which cards appear under the fixed AI Assistant box: help articles, documentation, news, a direct message CTA, external links, or form triggers. Reorder them with the Move Up / Move Down arrows. Full details in Home Screen Cards.
Set up your menu tabs
Home and Messages are always in the floating dock. The Help, News and Roadmap tabs have show/hide switches on the Widget tabs tab, with the feature each belongs to. Tab names are fixed and said in each visitor's language. See Branding, Menu & Dark Mode.
Check Your Changes in the Live Preview
A live preview of your widget sits beside the settings (on a narrower screen, the Edit and Preview buttons at the bottom swap between the two). Every change shows up there as you make it. Above the preview, a line says "Changes show here as you make them.", and once something is waiting to be saved it changes to "Showing your unsaved changes. Visitors see them after you save."
The buttons above the preview let you:
- Show the Home screen or Show the chat, so you can look at either one without clicking through the widget
- Restart the preview, to start it again from the beginning
- Open the Test page, which tries your widget on a real page in a new tab. It shows your last saved widget, so save first to test new changes.
The top right of the designer shows Saved while nothing is waiting. As soon as you change something it shows Unsaved changes with Discard, which undoes every change since your last save, and Save changes. If you leave the designer with edits, it asks first: Save and leave, Discard changes or Cancel.
Where to Find Widget Settings
The widget designer has seven tabs, and every widget setting is on exactly one of them:
| Tab | What it controls | Learn more |
|---|---|---|
| Style | Logo and widget icon, widget color, brand colors, buttons & messages, cards, corners, the Home background layers, launcher, Starting points, Redesign with AI | Appearance & Theming |
| Home screen | Header greeting, welcome message, team avatars, home cards | Home Screen |
| Chat | Start screen, email capture, satisfaction ratings, inbox access | Live Chat |
| Widget tabs | The Help tab, News and Roadmap | News & Roadmap |
| Languages | Which languages your own texts are written in, what is still missing, and the two language switches | Widget Languages |
| Install | The embed code, identity verification and session replays | Installation |
| General | The widget's name (only your team sees it) and deleting the widget | Chat Widget |
What to Set Up Next
Once the widget is live on your site, explore these features to get the most out of it:
AI Chatbot
Set up AI-powered conversations with streaming responses, conversation starters, and automatic agent handoff.
Knowledge Base
Add help articles so visitors can find answers on their own — browsable by category with full-text search.