Setting Up Custom Domains

Use your own registered domain with CodaMail for a fully branded email experience

← Back to Support Documentation

Your Domain, Our Infrastructure

CodaMail lets you host your own registered domains with full feature integration. Your custom domains work exactly like our provided domains, including catch-all addressing, masked aliases, account aliases, mail filtering, blocking, and auto-encryption.

You can host unlimited domains. There is no extra charge for this feature.

Adding Your Domain

Step 1: Add the domain in CodaMail

  1. Log in and go to Settings → Private Domains
  2. Enter your domain name (e.g., example.com) and click Add
  3. CodaMail will generate a unique verification code and display two DNS values you need to add to your domain

Step 2: Add the verification TXT record

At your DNS provider (Cloudflare, Namecheap, GoDaddy, etc.), add a TXT record:

Type: TXT

Host: _codamail-verify.example.com

Value: (the verification code shown in CodaMail)

TTL: 300 or higher

The host and value fields are displayed in CodaMail with copy buttons for easy clipboard access. DNS provider instructions for Cloudflare, Namecheap, GoDaddy, AWS Route 53, DigitalOcean, and BIND are shown in an expandable section on the page.

Step 3: Verify the domain

After adding the TXT record, allow a few minutes for DNS propagation, then click the Verify button in CodaMail. Once verified, the domain status changes from Pending to Verified.

Step 4: Configure email DNS records

After verification, click the "DNS Records" button on your domain to see the full email configuration. Add these records at your DNS provider:

MX Record:

example.com    IN   MX   10   mail.pnsh.com

 

SPF Record (TXT):

example.com    IN   TXT   "v=spf1 a mx a:smtp.pnsh.com ~all"

 

DMARC Record (TXT):

_dmarc.example.com    IN   TXT   "v=DMARC1; p=reject; rua=mailto:dmarc@example.com"

The MX record directs incoming mail to our servers. The SPF and DMARC records help prevent others from spoofing your domain and improve deliverability.

Subdomains

If you have already verified a parent domain (e.g., example.com), any subdomains you add (e.g., shop.example.com) are automatically verified without requiring an additional DNS check. Simply add the subdomain in Settings → Private Domains and it will be active immediately.

What Works with Your Custom Domains

Once verified, your domain is fully integrated with every CodaMail feature:

Catch-all addressing - Receive mail to any address at your domain. Give out unique addresses on the fly (e.g., amazon@example.com, newsletters@example.com) without creating them first.
Masked aliases - Create masked aliases on your custom domain, with the same privacy separation and catch-all sub-addressing as our provided domains.
Account aliases - Enable your account name at your custom domain just like any of our 30+ domains.
Blocking & catch-all management - All blocking and catch-all controls work with your custom domain addresses.
Filters & auto-encryption - Sieve filters and PGP auto-encryption work with custom domain addresses. Create identities for your custom domain addresses to send from them.
CalDAV & CardDAV - Your custom domain integrates with calendar and contact sync.

Troubleshooting

  • Verification fails: DNS changes can take time to propagate. Wait 15-30 minutes and try again. Some providers may take longer.
  • Not receiving mail: Verify your MX record is set correctly. You can check with an online MX lookup tool. Make sure no other MX records exist with a higher priority (lower number) than 10.
  • Mail going to spam at recipients: Make sure your SPF and DMARC records are in place. These authenticate your domain and improve deliverability.
  • Pending domains are automatically removed after 30 days if not verified. If yours was removed, simply add it again.

If you need further assistance, contact helpdesk@codamail.com.