Embed domains

After you embed the script, you can limit which websites and pages the chatbot is allowed to load and run on. Find the setting under Configuration → Embed domains.

With no restriction (the default), the script works on any page where you place it. A whitelist or blacklist acts as a safeguard — for example when the script is left on a test domain by mistake, or you want the chat only on a specific part of the site.

1. How to do it

In the left menu under the selected agent, click Configuration.
In the right column, open the Embed domains card.
Under Embed visibility, choose a mode (see below).
If you choose whitelist or blacklist, fill in Domains / URLs — one entry per line.
Click Save.
Verify on the target page (or in Playground — playground hosts are always allowed).

2. Visibility modes

All websites (default)

The script may run wherever you embed it. Suitable for first deployment and normal operation without restrictions.
Whitelist only

The chatbot loads only on the domains or URLs you list. On other pages the script does not run.
Blacklist

The chatbot does not load on the listed domains or URLs. Everywhere else the script is embedded, it works as usual.

3. How to write domains and URLs

In Domains / URLs, enter one entry per line:

Entry	Matches
`example.com`	The whole domain including subdomains (`www.example.com`, `shop.example.com`, …)
`https://example.com/blog`	The same host, only paths under `/blog`

Tips:

Use a domain without a path when you want to allow (or block) the whole site.
Use a URL with a path when the chatbot should run only in one section.
Empty lines are ignored.

4. What whitelist does not cover

Whitelist and blacklist control where the script is allowed to run. They do not by themselves decide which pages you embed the script on.

You want the chat only on part of the site and use GTM → combine the Kanbu whitelist with GTM trigger conditions — see Deploying on the web.
Playground (playground.kanbu.ai and the development environment) and localhost are always allowed so you can test without editing the list.

Frequently asked questions

I embedded the script but the chatbot does not appear. Could it be the whitelist?

Yes. If Whitelist only is on and the current URL is missing from the list, the script will not run. Add the domain or URL, save, and reload the page (hard refresh if needed).
Do I need to add Playground to the whitelist?

No — playground and localhost are allowed automatically.
Should I enter www.example.com or without www?

example.com covers subdomains including www. Prefer the root domain when you want to allow the whole site.

Back to Deploying on the web Continue to Operations management