Skip to main content
Web Widgets and Website Chat

Customize Layout, Branding and Colors

Match the widget to your client's brand: style, logo, icon, position, size, corners, theme, colours, title, call-to-action button and footer, checked in Live Preview.

Written By voiceaiwrapper

Last updated 26 days ago

Your widget should look like it belongs on your client's business website, not like a third-party add-on. This article walks through every look-and-feel setting in the widget builder: style, logo, icon, position, size, corners, theme, colours, title, call-to-action button and footer.

Each change shows up straight away in Live Preview, so you can try things before saving.

Before you start

How the builder is laid out

The builder has three tabs above the form, with the Live Preview panel next to it (below it on smaller screens):

  • Configuration: interaction mode, agents, style, branding, layout, theme and colours. Most of this article.
  • Content: the title, subtitle, button text and footer.
  • Settings: behaviour, limits and consent. See Voice and Chat Settings.

Some sections only appear when they apply. For example, chat colours appear only when chat is turned on, and the call-to-action settings only for the Card style.

The widget builder on its Configuration tab, scrolled to the Branding, Layout and Theme sections, with a logo uploaded, Position set to Bottom Left and Theme set to Dark. The Live Preview panel on the right shows the closed widget in the dark theme with the uploaded logo, in the bottom-left corner of the preview area.

Widget style

Under Widget style, choose how the widget looks before a visitor opens it:

StyleWhat visitors see
Card (default)Logo, title and subtitle, with a separate call-to-action button.
CompactOne clickable block with logo, title and subtitle.

Branding

SettingWhat it does
LogoClick Choose file to upload an image. Use a square logo, max 2 MB. Larger files are refused with "File size must be less than 2MB". Use Change logo to replace it or the Γ— on the thumbnail to remove it.
IconThe icon shown on the call-to-action button and when the widget is minimised. The default is a phone.

Layout

SettingOptionsDefault
PositionBottom Right, Bottom Left, Top Right, Top LeftBottom Right
SizeTiny, Compact, LargeCompact
Border RadiusNone, Small, Medium, Large (how rounded the widget's corners are)Medium
CTA Button Border RadiusNone, Small, Medium, Large, Full. Card style only.Medium

Theme

Pick Light (default) or Dark.

Changing the theme resets four colours: Background Color, Text Color, Accent Color and CTA Button Color. Light sets a white background with black text, accent and button. Dark sets the opposite. Choose the theme first, then set your brand colours.

The Theme section also holds Voice Animation Style when voice is on. See Voice and Chat Settings.

Colors

Click a colour swatch to pick a colour or type a hex code.

GroupSettingsWhen it shows
General colorsBackground Color, Text Color, Accent Color, CTA Button Color, Footer Text ColorAlways
Chat colorsChat Connected Status Color (the "connected" dot, green by default), Chat End Button Color (red by default)Chat is on
Voice colorsConnected Status Color (green by default), End Call Button Color (red by default)Voice is on, on VAW Native and ElevenLabs

Text on the call-to-action button switches between dark and light automatically to stay readable on the CTA Button Color you pick.

These are on the Content tab.

SectionSettingDefault
GeneralTitle"AI Assistant". On a VAW Native agent widget, the agent's name.
GeneralSubtitle"Get instant help from our AI"
CTA (Card style only)CTA Button Text"Start Conversation"
FooterFooter TextEmpty. Optional text shown below the widget, such as your agency's name.
FooterFooter Link URLEmpty. When set, the footer text becomes a link that opens in a new tab. It must be a full address, such as https://example.com; otherwise you'll see "Please enter a valid URL".

The Content tab also holds the button text and messages for voice and chat. See Voice and Chat Settings.

Check and save

  1. Look at the widget in Live Preview. Open it and start a conversation to see the open state in your colours. Preview conversations are real, so they use AI credits on VAW Native.
  2. Click Update Widget Configuration. You'll see Widget updated successfully.

Saved changes reach every site that uses the widget's embed code. You don't need to paste the code again.

Frequently asked questions

It only turns on when you've changed something since the last save. If you've made changes and it's still greyed out, you may only have view access to this widget (for example in the client portal).

Switching between Light and Dark resets the background, text, accent and button colours. Set your brand colours again after choosing the theme, then save.

The widget shows only what you set: your logo, title, subtitle, button text and footer. To serve the widget's code from your own domain as well, connect a custom domain for your client portal. See Connect Your Custom Domain and Embed the Widget on a Website.