Widget overview
The Widget Editor is where you control everything Sam shows to your visitors — colours, name, welcome message, knowledge scope, and (on Pro) custom branding and human handover.
You’ll find it in the dashboard sidebar under Configuration → Widget Editor.
Multiple widgets
Plans determine how many widgets you can run:
| Plan | Widgets |
|---|---|
| Trial / Starter | 1 |
| Growth | 3 |
| Pro | 5 |
Use multiple widgets when you want different behaviour on different sites or pages. Common patterns:
- Sales widget on the marketing site, support widget on the help centre
- One widget per language
- Different widgets for different product lines, each with its own knowledge tags
Each widget has its own API key, allowed origins, colours, persona, and knowledge scope.
What you can customise
| Page | What’s there |
|---|---|
| Appearance | Colours, position on the page |
| Personality | Name, welcome message, system prompt, knowledge tags |
| Branding | Hide “Powered by Sam”, custom colour palette |
| Human handover | Live agent takeover, working hours, agent nickname |
Save vs publish
The Widget Editor saves changes immediately. The next time a visitor opens the chat, they’ll see the new config (the widget script caches config for a few minutes via CloudFront, so changes can take up to 5 minutes to propagate to all visitors).
Allowed origins
Each widget has an allowed origins list — the domains the widget is permitted to load on. Add one origin per line, e.g.:
https://example.comhttps://www.example.comhttps://staging.example.comRequests from any other origin are rejected. This stops other sites from embedding your widget.
API key
Each widget has a unique 40-character API key, embedded in the install snippet. If you suspect it’s been leaked, click Regenerate API key — your existing snippet will stop working until you update it on your site.
Test environment
Every widget has a built-in test page where you can chat with it before going live. Open it from the Widget Editor with the Test button. The test page is a private URL that only authenticated dashboard users can access.
What’s next
Start with Appearance to set the look, then Personality for what Sam says.