Widget customization

Open Widget

Dashboard → Widget (/customization) configures the web widget for the currently selected agent (use the agent switcher in the navbar).

The Widget Customization screen uses Home (and other tabs such as Messages, FAQ, Style, Layout) on the left, settings in the center, and a live preview of the widget on the right—including the launcher and proactive bubble.

What you can customize

Typical options include:

• Colors, position, launcher label or icon
• Greeting or default prompts
• Domains or origins allowed to load the widget (per product rules)

Exact fields match your deployment’s UI.

Saved settings

Widget appearance and behavior are persisted per agent as widget settings in the backend—changes here affect every embed that references that agent’s IDs.

Relationship to Integrations

Integrations (/integrations) provides copy-paste snippets for HTML, React, Next.js, JavaScript, and Framer, using your organization and agent IDs. Customize the widget here first, then paste the snippet on your site.

Widget app

The monorepo ships a dedicated widget app (apps/widget) that serves widget.js—in development it may proxy chat to the main web app. Production URLs appear in your environment configuration.

Testing

1. Select the correct agent.
2. Finish visual settings on Widget.
3. Copy the snippet from Integrations and test on a staging page before production.

See Embed platforms for per-framework steps.