Embed Widget
Add a floating chat widget to your website with a script tag or an iframe.
Open Dashboard → Agents → your agent → Embed to configure and deploy the widget. It has three tabs.
Configure Content
- Brand name, welcome message, starter messages, and message placeholder text
- UI language: English, Hindi, Spanish, or French
- Enable/disable message feedback (thumbs up/down)
- A dismissable notice (rich text, up to 200 characters)
- Footer text (up to 200 characters)
Styling
- Profile picture
- Brand, accent, background, and text colors
- Chat bubble alignment (left or right)
- A live preview of the widget as you edit
Deploy
Copy one of two embed snippets:
<script
src="https://your-mozo-domain.com/embed/widget.js"
data-agent-id="YOUR_AGENT_ID"
async
></script>The script method injects a fixed-position iframe (360×600px) into the page for you and is the simpler option for most sites. The iframe method gives you full control over placement if you want the chat embedded inline rather than floating.
You can override widget colors via query parameters on the embed URL, for example
?primary=%236366F1&alignment=right. See
Widget Script Reference for the full list of
supported attributes and query parameters.
Before you go live
Review Security & Access Control — by default the widget requires a signed session and only allows origins you've explicitly listed. If you embed the widget on a new domain and it doesn't load, this is the most common cause.