Appearance and branding

Appearance in the dashboard sets the tokens every element in the builder draws from. Change your brand colour here and the whole widget follows — the launcher, buttons, links, focus rings.

What you can set#

Logo, dark-mode logo and description live in Settings. The current public docs renderer uses the regular logo; email templates have their own builder and do not automatically inherit these logo fields.

Choosing a colour#

The primary colour is used for the launcher and for anything a visitor is meant to click, so contrast matters more than brand fidelity. A colour that looks elegant on your marketing site can make a button label unreadable at 14px.

If your brand colour is very light or very dark, use it for the logo and pick something with more contrast here.

Corner radius#

0 gives sharp corners, 24 very round ones. The value applies to the whole widget at once — the point is consistency with your product, not per-element control.

The welcome message#

This is the highest-leverage text in the whole widget. It's the only thing a visitor reads before deciding whether to type.

Say what the assistant can actually do:

Ask about orders, returns or your account — I can look up your order if you verify your email.

That sets an expectation the AI can meet. Compare:

Hi! How can I help you today?

which sets none, and gets you "I need help" as a first message every time.

Overriding per page#

Colour and icon can be overridden on a single page with data-color and data-icon-url on the embed script. Use it for a genuinely different context — a co-branded partner page, say — not as a substitute for setting them properly here.

See Install the widget for the full attribute list.