Appearance and branding

Everything visual lives under Settings → Appearance. Changes apply to the live widget as soon as you save.

Bot name

The name shown in the chat header, and the value behind the {bot_name} placeholder in your responses. Required.

Bot avatar

Choose one of five built-in icons — Bot 1, Bot 2, Bot 3, Human, Chat — or upload your own.

For a custom icon:

1. Select Custom
2. Upload a PNG, JPEG, GIF, or WebP file
3. Maximum 512 KB and 512 × 512 pixels
4. Save

The icon is displayed at roughly 40 pixels, so fine detail and small text will not be legible. A square image with a transparent background and a clear silhouette works best.

Two switches control where it shows:

• Display bot avatar icon in chat window header — turn off for a plainer header. The chat toggle button always shows the icon regardless.
• Show background circle behind bot avatar in chat window header — adds a circular background behind the icon, and only applies when the avatar is visible

Primary colour

Sets the widget button and accent colours. Leave it empty to use the default green #4CAF50. Must be a hex value.

Worth checking:

• The contrast against the white icons on the bubble. Very light colours make the icon hard to see.
• How it looks on your product pages, not just your homepage.

Border radius

Accepts whole pixels only — 12px, 8px, 16px. Values in other units such as 1rem or 50% are rejected. Empty means the default 12px.

Test language

Sets the language used by the preview panel inside the dashboard. It defaults to your primary website language and never affects real visitors. Only languages you activated under Site info are offered.

Check your work

1. Open the Demo page from Settings → General settings
2. Look at it on a phone as well as a desktop
3. Confirm the bubble does not cover a sticky cart button or a cookie banner
4. Confirm the colour still reads well in your site’s dark sections

Related

• Test your chatbot before going live
• Chatbot and error messages