# Custom email domain setup guide - with screenshots.
This guide is an in-depth guide on how to register a domain name and setup an email inbox and email catch all for a custom domain.
# 1) Register a domain name
# Example using Hover.com
For this example we will register a domain name with hover.com (opens new window). You can use any domain name you wish.
A domain should be of the format
subdomain.test.com. Subdomain wild cards are supported by default with MailSlurp so you do not need to add subdomains separately.
# 2) Sign up for MailSlurp
Create a free account on MailSlurp by signing up (opens new window) with your email address.
Enter your email address and click submit. An access link will be sent to your email address. Open the email and click the access link to contine.
# 3) Add the domain to MailSlurp
Once you have logged in using the verification link navigate to the domain page.
Click the new domain button. Add your the domain name that you bought using the form and submit.
Domains must be verified to become active. Follow the next steps to add the verification records to your domain.
# 4) View DNS records in MailSlurp
To allow MailSlurp to send and recieve emails using your domain name you need to add some computer generated records to your domain provider DNS settings.
The DNS records generated are unique to your account so please view the dashboard and don't copy directly from the documentation.
The records are displayed like this:
Use these records and add them to your domain provider in the way covered next. We recommend opening the domain page and your domain provider side by side to copy paste the values.
# 5) Add DNS records to Domain Provider
# Add verification TXT record
First step is to copy the
TXT record from the MailSlurp dashboard domain overview page to your domain provider DNS settings. Here is an example:
Once you have add the verification record to your provider refresh the domain page in MailSlurp to check the verification status.
When the domain is verified is can be used with MailSlurp to send and receive emails. Verification can take up to 24hours but if it takes more than an hour double check your records because there may be a small mistake somewhere.
# Add MX inbound record
To receive emails using your custom domain you must add an MX record.
Many hosting providers split MX record entry fields into a
- If you encounter two fields enter
inbound-smtp.us-west-2.amazonaws.comfor the value.
- IF only one field is given for the MX record enter the priority and the value separated by a space like so:
# Add C Name DKIM records
DKIM records all you to verify your domain is not spam. These records vastly improve receive rates. Add the records like so:
# All records
You should add all the records given on the domain page. An example is below:
# 6) Test domain verification
Go to the MailSlurp dashboard (opens new window) and view the domain page.
Use the domain testing widget to test your records match those that are provided.
# Check verification
If verified the domain card will show the verified badge.
By default a wild card inbox is created to collect all emails sent to your custom domain that do not match with an inbox you have created. See the expanded catch all fallback guide for more information.
# 7) Start using your domain!
Now you are verified you can create an inbox using your domain.
# Create custom address using domain
You can create any email address you like using a verified domain. You can also setup a catch all to act as a wildcard match for all emails on the domain.
View the custom inbox like so: