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

# Quickstart

> Put the assistant on a page in five minutes. Two tags, no build step, no server code.

This puts the **public door** on a page: an assistant for anonymous visitors, answering on the data you marked public. For logged-in customers, follow the [per-user door](https://docs.concatflow.com/guides/per-user-door.md) next.

## Before you start

In the [Concatflow dashboard](https://app.concatflow.com), open your assistant and check three things:

* In the **Doors** tab, the **public door** is on and its scope lists at least one table.
* In the **Doors** tab, **Allowed origins** lists the origin of your page, for example `https://www.example.com`. Add your local origin too, such as `http://localhost:3000`.
* The assistant is **published**.

> [!NOTE]
>
> An origin is a scheme, a host and a port. No path. `https://example.com` and `https://www.example.com` are two different origins.

## 1. Copy your site token

Your site token starts with `st_`. You find it in the snippet of the assistant's public door. See [Where to find your identifiers](https://docs.concatflow.com/identifiers.md).

The site token is public. It is meant to sit in your page's HTML, like a Stripe publishable key.

## 2. Paste two tags

Paste this where you want the search bar to appear. Replace the token.

```html index.html theme={"system"}
<script src="https://app.concatflow.com/widget.js"></script>
<concatflow-assistant site-token="st_YOUR_SITE_TOKEN" launcher="bar"></concatflow-assistant>
```

The bar renders where the element is written. It takes the width of its container.

Prefer a chat bubble in the corner? Remove `launcher="bar"`:

```html theme={"system"}
<concatflow-assistant site-token="st_YOUR_SITE_TOKEN"></concatflow-assistant>
```

## 3. Ask a question

Open your page. Click the bar, or press <kbd>⌘</kbd> <kbd>K</kbd> (<kbd>Ctrl</kbd> <kbd>K</kbd> on Windows and Linux) to focus it. Type a question and press <kbd>Enter</kbd>.

The answer unfolds under the bar. Press <kbd>Esc</kbd> to fold it back.

> [!TIP]
>
> That's it. Every question is charged to your workspace credits. Your visitors never pay or sign in.

## Troubleshooting

> **The bar shows, but no answer comes back**
>
> Your page's origin is probably not in **Allowed origins**. Compare it character by character with `location.origin` in your browser console: scheme, host and port must match.

> **Nothing shows at all**
>
> Open the browser console.
>
> * `<concatflow-assistant> : attribut site-token manquant` means the `site-token` attribute is missing or empty.
> * A blocked script or frame means your Content Security Policy needs the Concatflow origin. See [Content Security Policy](https://docs.concatflow.com/guides/csp.md).

> **The assistant says it reached its limit**
>
> A monthly cap or your credit balance was reached. The assistant degrades to a short message instead of disappearing. Check the assistant's **Limits** tab and your credits.

## Next steps

> **[Search bar on a marketing site](https://docs.concatflow.com/tutorials/marketing-site.md)**
>
> A complete site: scope, bar, bubble, CSP and go-live.

> **[Per-user door](https://docs.concatflow.com/guides/per-user-door.md)**
>
> Answer each logged-in customer about their own data.

> **[Bar or bubble](https://docs.concatflow.com/guides/bar-or-bubble.md)**
>
> Pick the launcher that fits your page.

> **[Appearance](https://docs.concatflow.com/guides/appearance.md)**
>
> Theme, accent colour and placeholder.

> **[Go-live checklist](https://docs.concatflow.com/guides/go-live.md)**
>
> What to check before your customers see it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.