Whitelisting Domains

Allow your chatbot to appear on your website by adding your domain to the whitelist. This is required before your chatbot will work on any website.

Note:
This is a critical step — without whitelisting your domain, the chatbot will not appear on your website.

Hyperleap uses domain whitelisting as a security measure to ensure your chatbot only loads on authorized websites. You must add your domain before the chatbot embed code will work.

Adding a Domain

1

Open the Profile Menu

Click your profile icon in the top-right corner of the Hyperleap dashboard.

2

Go to Organization Settings

Select "Organization Settings" from the dropdown menu.

Profile dropdown menu with Organization Settings highlighted
Click Organization Settings from the profile menu
3

Navigate to the Domains Tab

In the Organization Settings page, click the "Domains" tab in the sidebar.

Organization Settings sidebar with Domains tab highlighted
Select the Domains tab from the sidebar
4

Add Your Domain

Enter your website domain in the input field (e.g., example.com) and click "Add Domain".

Allowed Domains page with domain input field and Add Domain button
Enter your domain and click Add Domain

Domain Matching Rules

Hyperleap uses smart domain matching to determine where your chatbot is allowed to load:

  • Base domain allows all subdomains — Adding example.com automatically allows the chatbot on www.example.com, blog.example.com, app.example.com, and any other subdomain.
  • www is treated as the base domain — Adding www.example.com has the same effect as adding example.com.
  • Specific subdomain restricts access — Adding app.example.com only allows the chatbot on that exact subdomain, not on example.com or other subdomains.
Tip:
In most cases, just add your base domain (e.g., example.com) and all subdomains will be covered automatically.

Common Scenarios

Single Website

If your chatbot should appear on your main website only, add your base domain:

  • Add example.com — covers example.com and www.example.com

Multiple Subdomains

If you want the chatbot on all subdomains (marketing site, app, blog, etc.):

  • Add example.com — automatically covers all subdomains

Specific Subdomain Only

If you want the chatbot only on a specific subdomain (e.g., your app but not your marketing site):

  • Add app.example.com — only allows the chatbot on app.example.com

Local Development

For testing during development, add localhost to the whitelist. Remember to remove it before going to production.

Note:
Remove localhost from your whitelist before going live to prevent unauthorized access during local development by others.

Next Steps

Once your domain is whitelisted, proceed to Publishing to get the embed code and deploy your chatbot to your website.