Skip to content
Docs: Allowed domains

Allowed domains

Your site key only works on the domains you list for your site.

Why it matters

The site key in your script tag is public. Anyone can read it in your page's HTML and paste it into their own. The allowed domains are what stop that: the mascot only answers on pages served from a domain on your list, and browsers on any other site are refused. Scripts outside a browser can pretend to be your site, so every site also has hourly and daily reply limits by plan, and each visitor and network address has its own, which keep the damage of such misuse small.

What goes on the list

When you add a site, its address and the www version of it are listed for you. Add every other hostname your visitors use, one per line:

  • a shop or help centre on a subdomain, such as shop.example.com;
  • a second domain that shows the same site;
  • a staging or preview address you want to test on before going live.

Each hostname is matched as written, so example.com and shop.example.com are two entries. Remove a staging address once you are done with it.

When the mascot doesn't appear

If the tag is on the page and nothing shows, the most common reason is a hostname missing from the list: compare the address in your browser with the list in the dashboard, character for character.