> 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/components/component-library/ai-components/component-chat-widget.md).

# Component: Chat Widget

**Available from:** Release 117

**Purpose**: Add Limio's conversational agent to a page as a floating chat launcher and popup.

In the Page Builder this component is called **Chat**. It places a launcher bubble in the bottom-right corner of the page; clicking it opens a chat panel where visitors talk to the same conversational agent described in [Limio Agents](https://docs.limio.com/ai/limio-agents). For a panel that sits in the page layout instead of floating, use the [Chat Panel](/components/component-library/ai-components/component-chat-panel.md) component.

## Behaviour

* The agent's greeting appears when the panel opens. The conversation is created on the visitor's first message.
* Visitor messages appear immediately; a typing indicator shows while the agent replies.
* Replies render markdown: bold, lists, links, and tables.
* The agent can surface interactive elements inline, such as a file upload, when a conversation calls for it.
* Authentication is automatic for signed-in customers and guests on your shop domain. Guests are supported through a scoped token issued on their first message.
* If a checkout submission fails on the page, the launcher draws attention to itself so the visitor has a route to help.

## Configuration

Add the **Chat** component to a page to enable the widget. Because the launcher is anchored to the corner of the screen, it floats in place regardless of where the component sits in the layout.

The greeting and the agent's behaviour are set in the agent configuration for your environment, not on the component. The widget's appearance follows your Limio theme (the shared design tokens), so it stays visually consistent with the rest of your shop.

{% hint style="info" %}
The Chat component shows a few fields in the Page Builder (heading, welcome message, and so on). These are reserved for a future release and do not change the widget yet. Set the greeting in the agent configuration.
{% endhint %}


---

# 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/components/component-library/ai-components/component-chat-widget.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.