> For the complete documentation index, see [llms.txt](https://docs.limio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.limio.com/agents/chat-embed/chat-embed.md).

# Overview

The chat embed puts your Limio AI agent on any page: your marketing site, a campaign landing page, a CMS you don't control the build for. You paste a script tag; the widget handles the rest.

It is the same ready-made chat widget your Limio shop pages use, with the same agent configuration, [theming and launcher branding](/agents/limio-agents/theming.md). The embed changes where it runs, not what it is.

{% hint style="warning" %}
**Early access:** The chat embed is in early access. Details of the snippet may still change; your Limio contact will tell you if an update is needed.
{% endhint %}

## Embed, panel or custom surface?

| You want                                             | Use                                                                                                             |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| The floating chat widget on a site **outside Limio** | The chat embed (this section). A script tag; no code.                                                           |
| The floating chat widget on your **Limio shop**      | Nothing to install. Configure the agent in the admin; see [Limio Agents](/agents/limio-agents/limio-agents.md). |
| An **in-page** chat surface on a Limio page          | The Chat Panel component in the Page Builder.                                                                   |
| Your **own chat UI**, any behaviour, any look        | A custom surface built on the client SDK; see [Getting Started](/agents/limio-agents/getting-started.md).       |

The embed surfaces the widget as-is. If you need different markup or behaviour, that is a custom surface, not an embed option.

## How it works

The snippet loads a small bootstrap script (about 2 kB). The bootstrap creates a chat session with your Limio tenant, then lazy-loads the widget itself, React and all styles included; there is nothing else to install. Styles are scoped to the widget, so they don't affect your page and your page's CSS doesn't affect the widget.

Visitors chat as guests by default. Each guest gets a session that persists across page navigations on your site. If your site knows who the visitor is, you can pass that identity to the widget so the same person gets the same conversation history on any device; see [Identifying visitors](/agents/chat-embed/identity.md).

## What you'll need

* **Your Limio shop domain** (it serves the embed script), from your Limio contact
* **Your site's origin on the tenant allowlist**: Limio configures which websites may start chat sessions for your tenant (`https://www.example.com`, scheme and host, no path). Requests from other origins are rejected.
* **An HTTPS site**: the identity features require a secure context
* **A configured chat agent** in your Limio environment

## Pages in this section

* [Setup](/agents/chat-embed/setup.md): paste the snippet and allow your origin
* [Identifying visitors](/agents/chat-embed/identity.md): recognise logged-in users with a signed assertion
* [JavaScript API](/agents/chat-embed/api-reference.md): control the widget from your own code


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.limio.com/agents/chat-embed/chat-embed.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.