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.