Skip to main content

Theming

The Theming tab lets you customize the look and feel of the chat widget with a live preview that updates in real time.

Theming

Identity

Configure the visual identity of the assistant shown in the chat header.

SettingDescription
AvatarUpload a custom avatar image (PNG, JPG, WebP, max 5 MB, resized to 200x200px)
Assistant NameDisplay name shown in the chat header

Layout

Control the shape and typography shared across all chat components.

SettingDescription
Border RadiusCorner rounding for the chat card (e.g., 8px, 16px)
Font FamilyOverride the default typography (leave blank to inherit from the host page)
ShadowCard drop shadow depth: none, sm, md, or lg
BorderToggle to show or hide a subtle border on the chat card

Colors

Define color palettes for light and dark modes.

  1. Select a Default mode (Light or Dark) that is used on initial load
  2. Switch between the Light mode and Dark mode sub-tabs to configure each palette independently
  3. Adjust individual color values for backgrounds, text, accents, and other UI elements

Live Preview

The right-hand panel shows a real-time preview of the chat widget as you make changes. Use the three preview tabs to see different widget states:

Preview TabShows
FABThe floating action button (collapsed widget)
ChatbotThe full chat window with messages
PopupsNotification and popup styles

Toggle between light and dark mode previews using the sun/moon icons in the top-right corner of the preview panel.

Every change you make on the left is reflected instantly in the preview on the right, so you can fine-tune the appearance before saving.

Saving

Click Save at the bottom of the settings panel to apply your theming changes. The new theme takes effect immediately for all users of this assistant.

Next Steps