Add a domain
What happens from the moment you type a domain into the dashboard until it shows as active. This page covers the four DNS records, automatic setup, SPF merging, verification states and provider quirks. For the full walkthrough that also creates your first mailbox, start with Set up your email.
Last updated
If you just bought a domain, its registration progress updates in place while the page is open and you are online. The checks run in the background and do not reload the page.
Add your domain
- Open the Domains page in your dashboard and click Add domain.
- Enter your domain name, for example
example.com. - Click Add.
Shipmail detects your DNS provider (Cloudflare, GoDaddy, Route 53 and others) and shows it next to the domain.
Shipmail won't add a domain that isn't registered. That is usually a typo. Check the spelling, or click Find this domain to buy it from the Domains page.
If the domain already gets email at Google, Microsoft 365 or Zoho Mail, the setup page shows how to move it. You change the MX records, create your mailboxes as soon as the check passes, then import your old email.
Add the SPF, DKIM and DMARC records first and change the MX records last. Until the domain is verified, Shipmail asks sending servers to retry later, so email sent in the meantime arrives once it is, as long as you finish within 7 days of adding the domain. Once it is verified, Shipmail keeps email for addresses that don't have a mailbox yet for 48 hours, then returns it. Mailboxes need a plan or a free trial, so start one before you change the MX records. Without a plan, the setup page says which of these applies now and, once the domain is verified, the exact time it stops keeping that email.
Add the DNS records
If your DNS provider supports automatic setup, click Configure automatically and approve the changes at your provider. Shipmail returns to the dashboard and verifies the records after your provider applies them.
If automatic setup isn't available, the dashboard lists the records a pending domain needs. Add each one by hand at your DNS provider. The first record still to add is open, with a Copy button next to its value. Click a record's name (MX, SPF, DKIM or DMARC) at the top of the list, or the DNS records step, to jump to that record.
| # | Type | Host | Value |
|---|---|---|---|
| 1 | MX | @ | 10 mx1.shipmail.to |
| 2 | TXT | @ | v=spf1 include:spf.shipmail.to -all |
| 3 | TXT | shipmail._domainkey | v=DKIM1; k=rsa; p=... |
| 4 | TXT | _dmarc | v=DMARC1; p=reject |
The MX (mail exchange) record sends incoming email to Shipmail. SPF (sender policy framework) lets Shipmail send email for your domain. DKIM (domainkeys identified mail) signs your outgoing email so recipients can check it really came from you. DMARC (domain-based message authentication) tells receiving servers what to do with a message that fails those checks. A domain can't finish setup until all four pass. See understanding DNS records for each record in detail, and how they work together.
SPF record merging
DNS allows only one SPF record per domain. If you already have one (for Google Workspace or another email provider), merge the two instead of adding a second record.
Shipmail detects an existing SPF record and suggests a merged value. For example, if your current SPF record is:
v=spf1 include:_spf.google.com -allReplace it with:
v=spf1 include:_spf.google.com include:spf.shipmail.to -allWait for verification
Shipmail checks your DNS records every 30 seconds and verifies each one on its own. A green check appears next to each record as it propagates.
Propagation usually takes a few minutes, but can take up to 48 hours at some providers. Shipmail keeps checking, so you can close this page.
After all 4 DNS records pass, the domain moves to Finishing setup while Shipmail runs its final checks. This usually takes a few minutes, sometimes a few hours. Your DNS is already correct at this point, so there is nothing to do. We email you when the domain is ready.
After verification
A new sending domain can send right away, within your organization's daily limit. Newsletters sent from a new domain warm up over its first 14 days. See sending policy for the limits and the newsletter schedule.
You can also add two optional records so Gmail shows your domain as "mailed-by". See DNS setup.
Provider-specific notes
For detailed step-by-step instructions with provider-specific tips, see the DNS setup by provider guide.
Cloudflare
Go to your domain in the Cloudflare dashboard, click DNS in the sidebar, then Add record. Add each record type separately. For TXT records, paste the value exactly as shown.
GoDaddy
Go to My Products, find your domain, click DNS, then Add New Record. Add each record type separately. For the MX record, set priority to 10.
Namecheap
Go to Domain List, click Manage on your domain, then Advanced DNS. Click Add New Record for each entry. Use @ as the host for root records.
AWS Route 53
Go to the Route 53 console, select your hosted zone, and click Create record. For TXT records, wrap the value in double quotes. Leave the record name empty for root records.
Infomaniak
Open your domain in Infomaniak Manager, click DNS Zone, then Add an entry. Leave Source empty for root records. Choose the dedicated DKIM type for shipmail._domainkey, not generic TXT.
OVHcloud
Open Web Cloud, then DNS zones, select your domain, and click Add an entry. Leave Sub-domain empty for root records and remove old MX records before adding Shipmail.
Gandi
Open Domain, select your domain, and click DNS Records. In table mode, click Add for each record. Use @ for root records and remove old MX records before adding Shipmail.
Troubleshooting
Some records verified but not all
Each record is checked independently. If some show green checks but others do not, double-check the records that are still pending. Make sure the type, host, and value match exactly.
SPF record conflict
If you see a warning about an existing SPF record, do not add a second SPF TXT record. Use the merged value shown in the dashboard. Having two SPF records will cause email delivery failures.
Duplicate DMARC records
DMARC permits exactly one TXT record at the _dmarc host. If Shipmail finds more than one, delete the extras and keep the expected value shown in the dashboard. A custom DMARC policy also needs to be published as one record.
DKIM TXT record not found
Make sure the TXT record host is exactly shipmail._domainkey (not the full domain, your provider appends it). Copy the full DKIM value from the dashboard, including the v=DKIM1 prefix.
DNS provider not detected
Provider detection works by checking your nameserver records. If your provider is not detected, the setup process is the same. Add the records in your DNS provider and verification will work regardless.
For email delivery and email client issues, see more troubleshooting.
Frequently asked questions
What if I have never touched DNS before?
Your DNS settings are at the company you bought the domain from. Log in there, look for a DNS or Zone Editor section, and copy the values from the Shipmail dashboard into new records. The dashboard links to step-by-step instructions for the most common registrars.
How long does verification take?
Usually a few minutes. Shipmail rechecks your DNS records every 30 seconds and marks each one verified as soon as it propagates. Some providers cache records longer, so it can take up to 48 hours.
Can I use a domain I already use for email somewhere else?
Yes. Keep the old service running while you publish Shipmail's records and wait for verification, because DNS caches can still send mail there. Then create the matching mailboxes, import historical mail, test delivery, and run a catch-up import before you close the old service.
Do I need a separate domain for each project?
No. One domain can hold many mailboxes (for example hello@example.com and support@example.com), and you set up DNS once. Add another domain only when you want a different domain in the address (support@other.com).