Help Center
Customizing your website widget
Getting started

Customizing your website widget

Ada Lembicz
Ada Lembicz
3 min read
Oct 01, 2026

You can customize your website widget in Text to match your brand, your language, and your site layout. Pick a theme and colors, edit the widget text, and choose where it appears, with or without a website connected.

How do you customize your website widget?

  1. Go to Settings → Channels → Website widgets.

  2. Select the Customize widget option. You’ll be redirected to the on-site configurator.

customizing_your_website_widget_1_new
  1. In Setup for Team, select the Team you want to configure.

  2. Open Appearance, Language, or Visibility and adjust the settings.

  3. Click Save changes to apply the updates to your website widget.

What can you customize in the website widget?

The configurator groups all widget settings into three sections.

customizing_your_website_widget_2

Appearance

In the Appearance section, you can adjust the look and feel of the widget:

  • Theme — choose between light or dark mode.

  • Primary color — select from preset colors, pick your own, or use More color customization to fine-tune individual areas of the widget.

the Appearance section of the configurator showing Theme and Primary color

Language

The website widget is available in 48 languages, and you can select your preferred language using the dropdown menu.

the Language section showing the language dropdown and the editable text fields

This setting changes only the language of the widget interface. It does not translate customer or agent messages.

You can also edit the default phrases and text elements:

  • Welcome message

  • Default customer name

  • Message placeholder

  • Offline info — displayed when agents are away, and no human or AI Agent is available to accept the chat.

  • Queue info — displayed when customers are waiting in a queue.

  • Privacy policy — allows you to set and enable a consent message to inform your visitors about how their data is handled during chat.

To add a privacy note and stay compliant, read Collect customer details and add a privacy note.

customizing_your_website_widget_3

Visibility

The Visibility section allows you to control where and how the website widget appears:

  • Alignment — choose whether the widget appears on the left or right side of your website.

  • Edge distance — adjust spacing from the side and bottom edges, ensuring it doesn’t overlap important website content.

  • Device display — decide whether the widget should also appear on mobile devices.

the Visibility section showing Alignment, Edge distance, and Device display

Good to know

  • You don’t need a website to start. You can customize the widget on a default preview and add your website later.

  • Settings apply per Team. If a Team is used across several websites, its widget configuration is shared across all of them. Learn how to manage Teams in Teams management.

Frequently asked questions

  • Yes. You can open the configurator and customize the widget even if you haven’t added a website yet. You’ll work on a default preview, so you can set the theme, language, and position first and connect your website later by following the steps in Adding the widget to your website.

  • Widget settings are saved per Team, not per website. If the same Team is used across several websites, the widget looks and behaves the same on all of them. To customize the widget differently, select another Team in the Setup for Team dropdown before you change any settings.

What’s next?

Now that your widget matches your brand, explore other ways to get more from it:

  • Campaigns — Start conversations with visitors using proactive messages on your site.

  • Prepare your website widget for GDPR — Set up consent and privacy options so your widget meets data protection requirements.

  • AI Agents — Let an AI Agent handle visitor questions through your widget.