How to add a Custom Domain to your chatbot

How to add a Custom Domain to your chatbot

You can assign a custom domain to your chatbot. This is especially useful to folks who use Chatwith to build and resell amazing chatbots for their clients.
💡
Custom Domains are available only on our highest plans.

How to assign a Custom Domain

To add a custom domain to your Chatwith chatbot, follow the steps:
  1. Use chatbot dropdown to choose the chatbot you want to change the domain for
  1. Visit White-Label section in Settings
  1. Enter the subdomain you wish to use and click ‘Save’
  1. Use the provided table with configuration instructions to set DNS in your domain registrar (eg. Namecheap or GoDaddy).
 
notion image
 
💡
Some domain registrars (eg. Namecheap) expect only a subdomain part (instead of subdomain.example.com) in the Host field. Please refer to the documentation of your registrar for instructions.

How to use the Custom Domain

The moment you assign a custom domain to your chatbot, all URLs for it can be accessed using it (instead of the chatwith.so domain). This includes:
  • JS code snippet URL (eg. https://your.domain.com/chatbot/{chatbotId}.js)
  • Shareable link and iFrame embed URL (eg. https://your.domain.com/embed/{chatbotId})
  • Dashboard URL (eg. https://your.domain.com/app)

FAQ & Troubleshooting

When I go to my custom domain it just shows my own page or an error, but not the chatbot. Why?

Please make sure to use the full link to your chatbot (with chatbot ID) that can be found in the dashboard. In case of partial URLs we’ll redirect to your root domain.

Can the dashboard be used with a Custom Domain?

Yes! Simply replace our domain (chatwith.so) with your custom one and the link to the dashboard will work the same. This comes useful when you invite your client as a team member and want to present a white labeled version of the dashboard.

I see “Pending Verification” next to my custom domain

This means that there is a collision in our domain system (eg. your domain was already used with another project) and that additional verification will be needed. Please reach out to support@chatwith.tools to resolve.

I see “Invalid Configuration” next to my custom domain

Please check the DNS settings again. The DNS can take a while to propagate. It takes a few minutes in most cases, but sometimes it can take more than 24h. You can use a free tool whatsmydns.net to check the CNAME record propagation for your subdomain.
 
Custom Domains will be recognized by Chatwith only if they propagate correctly; the image above shows CNAME records that have not propagated yet or have not been set at all.
Custom Domains will be recognized by Chatwith only if they propagate correctly; the image above shows CNAME records that have not propagated yet or have not been set at all.