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.