Iframe Embed
Embed the Limerence chat widget using an iframe.
Basic Embed
<iframe
src="https://your-instance.com/embed/AGENT_ID"
style="width: 100%; height: 100%; border: none;"
allow="clipboard-write"
title="Limerence Chat"
></iframe>Replace:
your-instance.comwith your Limerence domainAGENT_IDwith your agent's ID (found in Settings → Embed)
Finding the Embed Code
- Go to Settings → Embed in the Limerence dashboard
- Select your agent from the list
- Copy the generated iframe code
Iframe Attributes
| Attribute | Purpose |
|---|---|
src | The embed URL with your agent ID (/embed/AGENT_ID) |
allow="clipboard-write" | Lets users copy SQL queries and results |
style | Size and appearance |
title | Accessibility label for screen readers |
Sizing
The embed is responsive within its container. Common patterns:
Fixed Size
<iframe src="..." style="width: 400px; height: 600px; border: none;"></iframe>Full Container
<div style="width: 100%; height: 100vh;">
<iframe src="..." style="width: 100%; height: 100%; border: none;"></iframe>
</div>Sidebar Chat
<div style="position: fixed; right: 0; top: 0; width: 350px; height: 100vh;">
<iframe src="..." style="width: 100%; height: 100%; border: none;"></iframe>
</div>Styling
The embed uses a dark theme by default. The iframe itself can be styled with CSS:
<iframe
src="..."
style="
width: 100%;
height: 600px;
border: none;
border-radius: 8px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
"
></iframe>Features in Embed Mode
- Streaming responses — Answers stream in real time as the agent generates them
- Charts and tables — Query results render as interactive charts and data tables
- Agent shortcuts — Slash commands configured on the agent appear as clickable badges before the first message, and are available via the
/command palette during conversation - New conversation — A reset button appears after the first message to start a fresh conversation
- Copy SQL to clipboard — Users can copy the generated query (requires
clipboard-write) - Dark theme UI — The embed renders in a dark theme by default
Current Limitations
- No custom branding or theming — the embed uses the default Limerence dark theme
- No model selection — the embed uses the agent's configured model
- Sessions are anonymous — not linked to your application's user identity
- No persistent chat history — each page load starts a fresh session