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. An empty origin allowlist allows embedding from any site; add entries to
restrict to specific domains. Enable Allow local testing if you need to test a production
embed from localhost or 127.0.0.1 without opening your allowlist to every domain.