Configuration

Website Widget configuration is split into two areas: behavior controls what the widget does, and styling controls how it looks.

Behavior

Behavioral parameters control features like language, modal triggers, search mode, bot protection, and analytics. These do not affect how the widget looks — only what it does and how users interact with it.

See the full list of options in the Behavior reference.

Styling

The Website Widget is composed of individual components such as the launcher button, modal header, input fields, and conversation buttons. See the full list of available components.

Theming controls the global appearance of the widget — brand color, color palette, fonts, and color scheme. These settings apply across all components at once. For most use cases, theming is all that is needed.

Theming also includes color scheme support with the ability to sync with your site's dark mode toggle.

When a specific component needs to look different from the global theme, Component Styles allows overriding any theming value on a per-component basis. Component styles always take precedence over theming values.

View modes

The data-view-mode attribute applies a coordinated set of styles across multiple components with a single attribute, giving you a complete alternative layout. For example, the "sidebar" view mode turns the widget into a persistent right sidebar. Individual component styles can still be applied on top of a view mode. See View modes for details.