A chatbot that looks bolted on doesn't get used. Everything below lives under Widget Settings in your dashboard and updates live, so you can preview changes before anything goes to visitors.
The basics
- Chat title and welcome message — set the first thing a visitor sees when they open the widget.
- Primary color — matches the widget's accent color to your brand instead of the default indigo.
- Bot avatar — upload an image so the widget doesn't rely on a generic icon.
- Position and theme — pin the widget to a corner of the screen, and choose light, dark, or match-the-visitor's-system.
Guiding the conversation
- Placeholder text — the hint shown in the empty input box, useful for nudging visitors toward the kind of question your docs actually answer.
- Starter questions — a short list of clickable prompts shown when the widget opens, so visitors don't have to think of a question themselves.
- Show branding — toggle the "powered by" mark off if your plan supports it.
Handling the edges
- Offline message — shown when the widget is toggled off, instead of leaving visitors staring at nothing.
- Fallback message and escalation — configure what the chatbot says when it doesn't have an answer, and whether that hands the conversation to a human. See when to escalate to a human for how to think about this.
A note on where the widget can run
Allowed origins restricts which domains are permitted to load your widget using your API key, so a copied embed snippet can't be reused on someone else's site. Set this once you've settled on the domain(s) the widget will actually live on.
Related reading
- Embedding the widget in 5 minutes — get the widget live before styling it.
- A tour of the Lumen Chat dashboard — where widget settings sit relative to everything else.
Every one of these settings takes effect immediately — no rebuild, no redeploy. Open your widget settings and make it look like it was built for your site, because it was.