By default, Crisp provides an hosted Helpdesk domain (eg. acme.crisp.help). However, it is possible (and recommended!) to configure a custom Helpdesk domain (eg. help.acme.com).

Some DNS managers only require the beginning of the subdomain. For instance, instead of CNAME support.yourdomain.com you will have to provide CNAME support instead (without .yourdomain.com). Please compare with your other DNS entries.

Video Tutorial



Technical Setup

To configure a custom domain for your Helpdesk, follow those steps:

Go to your Crisp Dashboard
Go to Settings, then click on Helpdesk
Click on Setup your Helpdesk
In Custom domain, enter your desired custom domain
Click on Use this domain
Do not click on verify yet, first, add the indicated DNS records to your DNS manager and deploy your new DNS configuration
Again, do not click on verify, hold on for a at least 1 minute, to ensure your DNS provider propagated your changes
Now, click on Verify domain setup. Crisp will query your DNS records to ensure they are properly configured. This takes up to 20 seconds
Crisp will acknowledge or reject the domain change. If it rejects the changes, check all records have been added to your DNS manager
Once the domain change is validated, a new SSL certificate for your Helpdesk will be generated. This may take up to 2 minutes. Check your newly configured domain after this delay.

The Helpdesk custom domain setup

Third Parties Tutorials

Here are tutorials for most providers:
Cloudflare: https://support.cloudflare.com/hc/en-us/articles/200168756-How-do-I-add-a-subdomain-to-my-site-
GoDaddy: https://pl.godaddy.com/help/add-an-a-record-19238
Namecheap: https://www.namecheap.com/support/knowledgebase/article.aspx/319/2237/how-can-i-set-up-an-a-address-record-for-my-domain
Gandi: https://wiki.gandi.net/en/dns/zone/a-record
OVH: https://www.ovh.com/world/g1604.web_hosting_how_to_edit_my_dns_zone

If you are using Cloudflare DNS, make sure the "Cloudflare proxy" mode is disabled for all DNS records you added. Ensure the cloud icon is grey (disabled) and not orange (enabled). This prevents Cloudflare from rewriting the DNS records.

On most providers, if you need to configure MX mails.acme.com, you will have to configure "mails" only on the DNS provider's dashboard. (You will have to remove acme.com)
Was this article helpful?
Thank you!