Getting Started

Configure the Yaplet chat widget for the first time, and learn which tab of the widget designer holds each setting.

Haven't installed the widget yet? Head to the Installation guide for the embed code and platform-specific setup instructions.

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.

You don't have to complete every step before going live. The widget works out of the box with sensible defaults — you can refine the look and content over time.

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:

TabWhat it controlsLearn more
StyleLogo and widget icon, widget color, brand colors, buttons & messages, cards, corners, the Home background layers, launcher, Starting points, Redesign with AIAppearance & Theming
Home screenHeader greeting, welcome message, team avatars, home cardsHome Screen
ChatStart screen, email capture, satisfaction ratings, inbox accessLive Chat
Widget tabsThe Help tab, News and RoadmapNews & Roadmap
LanguagesWhich languages your own texts are written in, what is still missing, and the two language switchesWidget Languages
InstallThe embed code, identity verification and session replaysInstallation
GeneralThe widget's name (only your team sees it) and deleting the widgetChat Widget
Three things are not widget settings. Your public web address and the interface language belong to the brand and are set under Brand settings. Which knowledge base the widget's Help tab shows is decided under Brand → Knowledge — the Widget tabs tab only controls whether the tab appears at all.
For a full walkthrough of the widget designer, see the Chat Widget dashboard documentation.

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.

News & Roadmap

Share product updates and let visitors vote on upcoming features through the built-in roadmap board.

Forms & Surveys

Collect visitor data with multi-step forms, rating scales, and file uploads — triggered by agents, AI workflows, or surveys.

© 2026 Yaplet. All rights reserved.