Managing Domains
Domains allow you to send emails from your own custom addresses like hello@yourcompany.com instead of a shared domain.
Why Add a Custom Domain?
- Professional appearance - Emails come from your brand
- Better deliverability - Build your own sender reputation
- Full control - Manage your email authentication settings
Accessing Domain Settings
- Go to Organization Settings (gear icon in sidebar)
- Click Domains tab
Adding a Domain
Step 1: Add the Domain
- Click Add Domain
- Enter your domain name (e.g.,
yourcompany.com) - Select your preferred AWS region
- Click Add Domain
Step 2: Configure DNS Records
After adding a domain, you'll see a list of required DNS records. Add these to your DNS provider (Cloudflare, Route53, GoDaddy, Namecheap, etc.).
Required Records
| Record Type | Purpose |
|---|---|
| MX | Handles bounce notifications |
| TXT (SPF) | Authorizes Mailer to send on your behalf |
| CNAME (DKIM) | Cryptographically signs your emails |
| TXT (DMARC) | Sets your domain's email policy |
Adding DNS Records
The exact steps vary by DNS provider, but generally:
- Log into your DNS provider's dashboard
- Find the DNS or Records section
- Add each record with the exact values shown
- Save your changes
Important: Copy the values exactly as shown. Extra spaces or incorrect formatting will cause verification to fail.
Step 3: Wait for Verification
DNS changes can take up to 48 hours to propagate worldwide. During this time:
- The domain status will show as "Pending"
- You cannot send emails from this domain yet
- Check back periodically to see the updated status
Step 4: Check Verification Status
- Return to Organization Settings → Domains
- Click Check Status next to your domain
- The system will verify each DNS record
Once all records are verified, the status changes to "Verified".
Setting an Active Domain
After verification, set the domain as your active sending domain:
- Find your verified domain in the list
- Click Set Active
- All emails from your organization will now use this domain
Viewing DNS Records
To view the required DNS records for a domain:
- Go to Organization Settings → Domains
- Click on the domain name
- View the full list of DNS records and their status
Each record shows:
- Record type and name
- Required value
- Current verification status
Troubleshooting Verification
Domain Stuck on "Pending"
- DNS propagation can take up to 48 hours
- Verify records are added to the correct domain
- Check for typos in the record values
- Use MXToolbox to verify your DNS records
SPF Record Failed
- Ensure only one SPF record exists for your domain
- If you have existing SPF records, merge them instead of adding a new one
- Example merged SPF:
v=spf1 include:amazonses.com include:other.com ~all
DKIM Record Failed
- CNAME records must not have a trailing dot in some DNS providers
- Ensure the full selector name is used (e.g.,
mailer._domainkey.yourcompany.com) - Check that the value points to the correct AWS endpoint
DMARC Record Failed
- DMARC records go on
_dmarc.yourcompany.com - Start with a relaxed policy:
v=DMARC1; p=none; - You can strengthen the policy later after monitoring
Removing a Domain
To remove a domain:
- Go to Organization Settings → Domains
- Find the domain you want to remove
- Click the delete icon
- Confirm removal
Warning: Removing a domain will prevent sending emails from that domain. Make sure to set a different active domain first.
Multiple Domains
You can add multiple domains to your organization:
- Each domain must be verified separately
- Only one domain can be active at a time
- Switch between domains by clicking Set Active
Use cases for multiple domains:
- Different brands or products
- Separating transactional and marketing emails
- Testing new domains before going live
Best Practices
Use a Subdomain for Email
Consider using a subdomain like mail.yourcompany.com instead of your root domain:
- Protects your main domain's reputation
- Easier to manage email-specific DNS records
- Allows different settings for email vs. website
Set Up DMARC Monitoring
Start with p=none to monitor without affecting delivery:
v=DMARC1; p=none; rua=mailto:dmarc@yourcompany.comThis sends reports to your email so you can monitor authentication results.
Warm Up New Domains
When using a new domain:
- Start with small batches (100-500 emails)
- Gradually increase volume over 2-4 weeks
- Monitor bounce and complaint rates
- Only scale up if metrics stay healthy