> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decimal.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Widgets

> Embed an AI-powered support chat on your website so customers can get instant answers from your knowledge base.

**Chat Widgets** let you embed a Decimal-powered AI support chat directly on your website. Customers can ask questions and get instant, grounded answers from your knowledge base — without opening a support ticket. Widgets work for both anonymous visitors and authenticated users.

## How It Works

When a customer asks a question through the chat widget:

1. The AI agent searches your **public** sources of information for relevant context
2. It generates a response in real time
3. If the issue can't be fully resolved, the customer can **escalate** to create a ticket in your connected ticketing system

<CardGroup cols={2}>
  <Card title="Installation" icon="code" href="/chat-widgets/installation">
    Add the widget to your site with a script tag. Configure display modes and theming.
  </Card>

  <Card title="Identity Verification" icon="fingerprint" href="/chat-widgets/identity-verification">
    Authenticate users with signed JWTs for verified sessions.
  </Card>

  <Card title="JavaScript API" icon="square-js" href="/chat-widgets/api-reference">
    Control the widget programmatically — boot, show, hide, update metadata, and customize themes.
  </Card>

  <Card title="Conversations" icon="comments" href="/chat-widgets/conversations">
    Review what customers are asking and how the AI agent is responding.
  </Card>
</CardGroup>

## Creating a Widget

Click **Create Widget** to get started. Enter a **name** and optionally specify **allowed domains** (e.g. `example.com`) to restrict where the widget can load.

## Widget Configuration

The configuration page is where you manage everything about a widget:

* **Logo** — Upload a custom logo for the chat header (recommended: 64x64px, JPEG or PNG)
* **Allowed Domains** — Control which domains can load the widget
* **Escalation** — Route unresolved conversations to your ticketing system (Plain, Pylon, or Linear)
* **Active / Inactive** — Toggle the widget on or off at any time

A live preview appears on the configuration page so you can see changes in real time.