Reference
Public & Embed

Public Pages and Embed

This section explains where your public agent page lives and how to embed it.

Public page

  • URL: https://chatolia.com/c/{publicId}
  • Shows the configured chat UI for your agent.
  • Honors model allowlist, speech, images, and web search settings.
  • Private agents require the owner or a workspace member to view.

Embed options

  • Widget snippet: adds a floating launcher on any page.
  • Iframe snippet: full‑page embed of the public agent page.
  • Find both under the “Deploy” button on the Agents page.

Widget attributes

  • data-agent (required) — the agent’s public id.
  • data-position — bottom-right, bottom-left, top-right, top-left.
  • data-width / data-height — initial chat size.
  • data-theme — system, light, dark.
  • data-icon-size — small, medium, large, xlarge.
  • data-icon-url and data-icon-style — widget icon and style.
  • Popup Hint attributes are available for optional announcement bubble.

Notes

  • Set NEXT_PUBLIC_WIDGET_ORIGIN for consistent production snippets.
  • Custom domains for public pages are available on paid plans.
Plan Limits