Custom Email Domain can be used to use your domain branding for all emails that Crisp sends to your users. Also, your users will be able to reply to your emails directly to your domain.

This guide explains you how Custom Email Domain works, and how to setup it. Custom Email Domain is available in Crisp Unlimited, which comes with a ton of other handy features for your shared inbox.

If you cannot or don't want to use our Custom Email Domain feature, you can still customize your Basic Email Domain, which provides an email domain such as: Check your website settings advanced configuration (configuration steps are similar than those listed below).

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

Video tutorial

What Custom Email Domain do?

The Custom Email Domain feature lets you use your own domain for emails sent by Crisp to your users, and vice-versa. Your users won't see the Crisp brand (eg. [..] anymore in email addresses generated by Crisp for unread message notifications, chat transcripts, campaigns, and inbound emails.

A message notification email sent by Crisp (default Crisp domain)

The email address you see in the screenshot above is generated from default Crisp mailing domain (ending in

For this conversation, the email is:
Using your own email domain (eg., the email will be seen as:

You and your user can directly reply to this email, which will still be routed to Crisp servers (as with

The Custom Email Domain feature only requires you to add a few DNS entries to your domain name manager. You won't need to install anything on your own server, or maintain anything over time. You can set it up and forget it.

Make sure not to alter (remove or edit) the DNS records you've configured, as this will cause issues with either receiving or sending emails via your Custom Email Domain.

Benefits of using a Custom Email Domain

Your team can get some benefits from using a Custom Email Domain:

You get to manage your own mailing reputation from your own domain name. This means, less chance that your emails go to the spam folder.
The Crisp brand won't be visible through email addresses. Your users see Crisp as fully integrated to your own branding (they have no way to see the Crisp brand in your communication).

Which email domain should I use?

The Custom Email Domain you choose to use for Crisp is important, as it will be seen by your users.

Consider this example scenario:

Your company is named Acme, Inc., and runs
You is already using an email provider on

Then, you will need to pick a sub-domain of to handle Crisp emails.

You cannot use the base domain, as it is already in use for your internal emails (eg. running employee emails as, if so, a Crisp custom email domain would conflict with your exisiting configuration.

Thus, you will need to choose a sub-domain of, that you dedicate to Crisp emails. We recommend the following sub-domain formats, but you can pick any sub-domain that's not already in use on your domain:

Sub-domain 1:
Sub-domain 2:
Sub-domain 4:
Or any other custom sub-domain (your choice!)

How to setup Custom Email Domain for my website?

Before you continue setting up the Custom Email Domain feature for your website, check that you meet the following requirements:

Your Crisp website is subscribed to Crisp Unlimited (see our plans)
Here are the tutorials on most providers:

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, you will have to configure "mails" only on the DNS provider's dashboard. (You will have to remove

Good. Now, you may proceed:

Go to your website settings on your Crisp Dashboard.
Pick the target website you need to use the Custom Email Domain feature on
Scroll down, and open Advanced configuration, then select Custom Email Domain
In the field asking for the domain, enter your desired Custom Email Domain (eg.
Click on Use this domain, then instructions will appear
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

Enter your Custom Email Domain, and then click use

DNS records are generated, make sure to add them all in your DNS manager

How to test your setup

Once the Custom Email Domain is active, you will see a green acknowledgement. Try sending emails to yourself using Crisp, eg. send yourself a chat transcript or create a campaign targeting yourself. Check that you receive the emails in your personal inbox. If you do not receive any email, check the following troubleshooting section.

If the emails land in your spam folder, or are not received at all, feel free to contact us. We'll gladly assist you on any issue you have.

How to use the same Custom Email Domain for multiple websites?

The Custom Email Domain feature can be used across multiple websites, using the same domain.

You just need to repeat the setup process for each desired website. You will only need to add one more DNS record per website, to prove the ownership of the Crisp website (namely, the TXT DNS record containing crisp-website-id). The other DNS records won't change across websites, so you can leave previous ones as-is.

Troubleshooting common issues

My DNS setup cannot be verified

If you had to fix a mistake and clicked on Verify domain setup again, Crisp may not succeed verifying changes immediately, even if all the records are properly setup. This is due to the DNS cache system, which takes time to refresh and propagate.

You may need to wait a few minutes to a few hours and re-enter your target email domain on Crisp, then verify again. In extreme cases, you may need to wait for a few days (if your DNS provider cache expiration values are very high).

My DNS is validated, but images and links are broken with an HTTPS error

Your domain may have a CAA record configured, that prevents our SSL certification authority (Let's Encrypt), from issuing certificates for your domain name, and any of its sub-domains. If you are using a DNS CAA record, please add to the issue property of your existing CAA entries (you would add this exact CAA value: issue "").

Note that, while we were able to generate your SSL certificates the first time that you configured your email domain, if you add a CAA entry to your DNS records that would not allow our certification authority to issue certificates, our systems will be thus unable to proceed renewal of your certificate in the future, leading to broken images and links in your emails.

My users do not receive emails anymore

Outbound emails sent by Crisp are secured by SPF and DKIM. SPF specifies which SMTP server is allowed to send emails on your behalf, while DKIM cryptographically signs outgoing emails. DMARC then enforces a policy based on SPF and DKIM for email receivers, telling them to reject all invalid emails from your Custom Email Domain (ie. domains that fail both SPF and DKIM verifications).

In case you and/or your users do not receive emails anymore, check that the SPF, DKIM and DMARC records that Crisp provides are correctly set, and not altered. Feel free to contact us if you have any question; we may have DMARC logs of what happened to your domain regarding DKIM and SPF.

My users cannot email me anymore

You may read this article dedicated to troubleshooting inbound email issues to Crisp Inbox.

Inbound emails sent by your users to Crisp require that the MX record that we provide in the email setup is correctly set. If your users cannot email you anymore, or reply to emails sent by Crisp to them, double check that the DNS MX record is still set, and matches the one provided during the Custom Email Domain setup in Crisp.

Also, check your website is still subscribed to Crisp Unlimited.

The Custom Email Domain was properly setup, but emails still come from default domain

Custom Email Domain requires a Crisp Unlimited subscription.

Check your website is still subscribed to Crisp Unlimited, as it will be disabled if you downgraded your plan, or if you didn't renew it.

I cannot find a fix for my issues

Too bad! Before contacting us, try reseting the Custom Email Domain to the default one provided by Crisp:

Go to your website settings on your Crisp Dashboard.
Pick the target website you need to use the Custom Email Domain feature on
Scroll down, and open Advanced configuration, then select Custom Email Domain
Reset the field asking for the domain (wipe any value, set it to blank)
Save, and wait for a few seconds. The default Crisp domain will now be used

Now, try the setup process again. Refer to the setup section for instructions.

If you still cannot fix your issue, then contact us. We'll make sure your issue gets sorted out quickly.
Was this article helpful?
Thank you!