Widget Configuration

The saved widget configuration in the dashboard is the source of truth for branding, copy, quick replies, actions, and routing. The embed snippet only needs a widgetId.

Where to configure the widget

Open Dashboard → Widget, make changes, and save. The loader fetches the latest config on page load, so updates appear without replacing the embed snippet.

Common settings

brandNamestringLabel shown in the widget header and previews.

primaryColorhex colorPrimary accent used for buttons, highlights, and selected states.

position'bottom-right' | 'bottom-left'Widget placement on the page.

welcomeMessagestringFirst message shown when the widget opens.

quickRepliesstring[]Suggested prompts displayed below the welcome state.

headerTitlestringHeader title override if you want copy different from the brand name.

headerSubtitlestringOptional subheading for trust, routing, or support context.

headerLogourlLogo shown in the widget header.

actionsWidgetAction[]Buttons for booking, pricing, docs, or in-chat follow-up flows.

teaserobjectOptional teaser bubble or returning-visitor prompt shown before the widget opens.

Canonical embed snippet

Embedhtml

<script src="https://app.clarm.com/widget/loader.js" data-widget-id="YOUR_WIDGET_ID" async></script>

What not to hardcode

Avoid shipping agent IDs, widget tokens, or brand copy in your site code. Those values are saved and versioned in the dashboard so non-engineers can update the widget safely.

Managed in the dashboardtext

- Connected agent
- Widget token
- Brand and header copy
- Quick replies and actions
- Booking form and live chat settings
- Product and teaser configuration