# 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

To use a custom email addresses with a domain name you need to register a domain with a domain (opens new window) name (opens new window) provider (opens new window). Any provider will work.

# 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.

buy email domain

TIP

A domain should be of the format test.com not https://test.com or subdomain.test.com. Subdomain wild cards are supported by default with MailSlurp so you do not need to add subdomains separately.

buy list

# 2) Sign up for MailSlurp

Create a free account on MailSlurp by signing up (opens new window) with your email address.

sign up 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.

sign up

# 3) Add the domain to MailSlurp

Once you have logged in using the verification link navigate to the domain page.

domains

Click the new domain button. Add your the domain name that you bought using the form and submit.

domains

WARNING

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.

TIP

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:

domains

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

domains

# 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:

domains

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.

domains

::: info Many hosting providers split MX record entry fields into a Priority and Value field.

  • If you encounter two fields enter 10 for Priority and inbound-smtp.us-west-2.amazonaws.com for the value.
  • IF only one field is given for the MX record enter the priority and the value separated by a space like so: 10 inbound-smtp.us-west-2.amazonaws.com :::

# 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:

domains

# All records

You should add all the records given on the domain page. An example is below:

domains_list

# 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.

tester

# Check verification

If verified the domain card will show the verified badge.

verified

TIP

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.

custom create

View the custom inbox like so: custom view