Skip to main content
Tune how the widget looks on your site — colour, welcome message, intro bubbles, quick questions, position, and branding. The Live preview next to the settings shows what you saved.

​
Open widget settings

Each AI agent has its own widget. Go to AI agents, open the agent and select the Channels tab. The settings live in the Web widget card. Settings → Widget only points there now.

​
What you can customise

The widget avatar is the AI agent’s avatar, set on the agent’s Profile tab. The brand logo is the fallback.

​
Plan-gated features

Two widget capabilities are locked behind plan caps:
  • Branding (hide the Keloa badge) — requires the widget_unbranded cap. Available on Business and Scale.
  • Working hours integration — requires the working_hours cap. Available on Business and Scale. Configure in Settings → Workspace → Business hours.
See Billing & plans for the full cap matrix.

​
Preview

The Live preview next to the settings runs the widget on a sandboxed host page (/widget/host-demo) with your saved settings. It updates when you save — useful for clicking through a real conversation without touching your site. Send test message next to the embed snippet checks that the agent answers.

​
Languages

The widget greeting is translated automatically into English, Dutch, German, French and Spanish. The visitor’s locale is detected from navigator.language, with the brand language as fallback. The Welcome message you type in the agent’s Web widget card is used as the operator-customised version for your brand’s primary locale.

​
Accessibility

  • WCAG 2.2 AA contrast on default theme colours.
  • The launcher is focusable via keyboard (Tab) and the chat panel is operable with arrow keys.
  • Screen reader announcements fire on every state change.

​
Mobile behaviour

  • The widget opens full-screen on mobile breakpoints.
  • The launcher offset honours iOS safe areas.

​
Identifying logged-in users

If your site authenticates visitors, your backend can sign a token that tells the widget who the signed-in user is. See Identity verification.

​
Save

Changes save automatically: the card shows Auto-saving, then Saved. The next loader fetch on your site picks up the change (CDN cache 60 seconds).