Customize the widget
Brand color, welcome text, assistant name, home-screen sections, greeting, suggested questions and allowed domains.
Everything visitors see in the widget, apart from the launcher button itself, is set under Widget Customization. The live preview on the right updates as you type and switches between the Home Screen and Chat views; nothing is saved until you click Save Settings.
Appearance and home screen
| Setting | What it controls | Rules |
|---|---|---|
| Brand color | The home-screen gradient, buttons and the active tab. | A hex color such as #006bff. |
| Welcome headline | The large text at the top of the home screen. | Required, up to 60 characters. Default "Hi there 👋". |
| Welcome subline | The line under the headline. | Up to 60 characters. Default "How can we help?". |
| Assistant name | Shown in the chat header and in the Messages list. | Required, up to 40 characters. Default "Support". |
| Home screen sections | The order of the Send us a message card and the Help search & top articles card, with ↑ and ↓ buttons. | The message card is always present. |
| Help tab & articles | Whether visitors get a Help tab and the help card. | On by default. Both only appear once you have published at least one Help Center article. |
Note
The launcher button in the corner keeps its own fixed style; the brand color styles the chat window. When you have no published articles the home screen switches to the chat-first layout described in Widget behavior.
General chat settings
| Setting | What it controls |
|---|---|
| Greeting message | The first message in every new conversation, and the first bubble on the chat-first home screen. Required. Changes apply to new conversations only. |
| Default suggestions 1 to 3 | Tappable quick replies shown before the visitor's first message. Optional. Each one starts a conversation with that text. |
Write the greeting as the agent: "Hi! I can check orders, explain our plans and book a call. What can I help with?" Suggestions work best as questions your content answers well.
Allowed domains
One domain per line. Subdomains are included automatically, and leaving the box empty allows every site. See Allowed domains for the matching rules.
Voice assistant settings
This card appears once Vapi is connected. Choose the Voice Assistant visitors talk to and the Display Phone Number shown on the Contact screen, or leave either as None.
Save and verify
Click Save Settings. A toast confirms "Widget settings saved". Open your site: settings reach a widget that is already open without a reload, apart from the greeting, which applies to the next conversation.
Something missing or wrong on this page? Tell us and we will fix it.