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

# Allowed Domains

> Lock your widget so it only runs on your own sites by keeping an allow-list of domains.

**Allowed Domains** is an allow-list of the sites where your widget is allowed
to run. It stops someone from copying your script and loading your bot on a
site that isn't yours.

If the list is **empty**, the widget works on **any** site. The moment you add
even one domain, the widget runs **only** on the domains you list.

## How matching works

* **Subdomains are included automatically.** Adding `example.com` also covers
  `shop.example.com` and `help.example.com`.
* **Wildcards** work too. Use `*.example.com` to match every subdomain.
* If a site **isn't** on the list, the widget won't load there at all.

For a travel agency, adding `travelco.com` covers the main site plus
`book.travelco.com` – one entry, every subdomain.

## Add a domain

<Steps>
  <Step title="Open the Deploy page" icon="rocket">
    In your agent's dashboard, open the **Deploy** page and find the
    **Allowed Domains** section.
  </Step>

  <Step title="Add your domain" icon="globe">
    Type your domain – for example `example.com` or `*.example.com` – and add
    it to the list. Repeat for each site that should run the widget.
  </Step>

  <Step title="Save" icon="check">
    Save the list. From now on the widget loads only on the domains you added.
  </Step>
</Steps>

<Warning>
  Before you embed the widget on a new domain, add that domain here **first**.
  If it isn't on the list, the widget will be blocked and won't load on that
  site.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Embed on your website" icon="code" href="/deploy/embed-on-website">
    Paste your script tag and put your bot live on your site.
  </Card>

  <Card title="Run several agents from one script" icon="robot" href="/deploy/multi-agent-routing">
    Show different agents on different pages from a single workspace script.
  </Card>
</CardGroup>
