Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

Learn how to configure your DNS records to verify your domain with MailBreeze. These instructions work for any DNS provider (Cloudflare, GoDaddy, Namecheap, Route 53, etc.).

​
Add Domain to MailBreeze

Log into your MailBreeze account and navigate to Domains to add a new domain. After entering your domain, you’ll see the DNS Setup screen with all required records.
MailBreeze domain setup modal showing DNS records
Use a subdomain (e.g., mail.example.com) instead of your root domain (example.com). This keeps your transactional email reputation separate from your corporate email. If your sending domain ever gets blacklisted, your main business email (Google Workspace, Microsoft 365, etc.) remains unaffected.
You can click I’ll do this later to access the dashboard, but you won’t be able to send emails until the domain setup is complete.

​
Domain Setup Page

After adding your domain, you can access the setup page anytime from Domains in your dashboard. Here you can:
  • Click Check to verify your DNS records
  • Click Send to IT to email the DNS details to your IT team
  • Click Zone to download the zone file for import
MailBreeze domain setup page with pending DNS records

​
Import DNS Zone File

The easiest way to configure your DNS records is to import the zone file directly. Most DNS providers support zone file imports.
1

Download Zone File

On the domain setup page, click Zone to download the DNS zone file.
2

Import to Your DNS Provider

In your DNS provider’s dashboard, look for an Import or Import Zone File option and upload the file you downloaded from MailBreeze.
Example: Cloudflare Import and Export button
The screenshot above shows Cloudflare, but most DNS providers have a similar import option in their DNS settings.
3

Verify Your Records

Before clicking Check in MailBreeze, verify your records are live using MXToolbox DNS Lookup. This helps catch any issues before verification fails.
4

Complete Verification

Return to your MailBreeze dashboard and click Check to verify your DNS records.

​
Manual Setup

If you prefer to add records manually or your DNS provider doesn’t support zone file imports, follow these steps. You’ll need to add 4 records:
RecordTypePurpose
VerificationTXTProves you own this domain
SPFTXTAuthorizes our servers to send email
DKIMCNAMESigns emails to prevent tampering
DMARCTXTTells receivers how to handle failures

​
Provider-Specific Notes

All DNS records must have proxy status set to DNS only (gray cloud icon). Orange cloud (proxied) will cause verification to fail.
GoDaddy automatically appends your domain to the Name field. If MailBreeze shows _mailbreeze.mail.example.com, enter only _mailbreeze.mail in GoDaddy.
TXT record values must be wrapped in quotes. For example: "v=spf1 include:_spf.mailbreeze.com -all"
Use @ for root domain records. Namecheap automatically appends your domain, so enter only the subdomain portion in the Host field.
TTL Tip: During initial setup, use a low TTL (300 seconds) so changes propagate quickly if you need to fix mistakes. After verification, you can increase it to 3600 or higher.

​
Add Your Records

1

Open Your DNS Provider

Log in to your DNS provider and navigate to the DNS management page for your domain.
2

Add Verification Record

Add a TXT record to verify domain ownership.
FieldValue
TypeTXT
Name / HostCopy from MailBreeze (e.g., _mailbreeze.mail)
Value / ContentCopy verification value from MailBreeze
TTL300 (or Auto)
The verification value will look like:
mailbreeze-verification=99235a0f3794e445be3340cf5f56e9725fe7ac53c05174fd86683123f5f4aed5
3

Add SPF Record

Add a TXT record for SPF authentication. This authorizes MailBreeze servers to send email on your behalf.
FieldValue
TypeTXT
Name / HostYour subdomain (e.g., mail)
Value / ContentCopy SPF value from MailBreeze
TTL300 (or Auto)
The SPF value will look like:
v=spf1 include:_spf.mailbreeze.com -all
A domain can only have one SPF record. Having multiple SPF records will cause email delivery failures.If you already have an SPF record from another provider (e.g., Google Workspace, Microsoft 365), MailBreeze will automatically combine them into a single record for you.If MailBreeze detects multiple SPF records for the same domain, it will alert you on the domain setup page, tell you which record to delete, and provide an updated combined SPF record to add.
4

Add DKIM Record

Add a CNAME record for DKIM authentication. DKIM cryptographically signs your emails to prove they haven’t been tampered with.
FieldValue
TypeCNAME
Name / HostCopy DKIM name from MailBreeze (e.g., mailbreeze._domainkey.mail)
Value / TargetCopy DKIM target from MailBreeze
TTL300 (or Auto)
The DKIM target will look like:
mailbreeze._domainkey.mailbreeze.com
5

Add DMARC Record

Add a TXT record for DMARC (Domain-based Message Authentication, Reporting, and Conformance). This tells receiving mail servers what to do when emails fail SPF or DKIM checks.
FieldValue
TypeTXT
Name / HostCopy from MailBreeze (e.g., _dmarc.mail)
Value / ContentCopy DMARC value from MailBreeze
TTL300 (or Auto)
The DMARC value will look like:
v=DMARC1; p=quarantine; rua=mailto:your-domain@dmarc-reports.mailbreeze.com; ruf=mailto:your-domain@dmarc-reports.mailbreeze.com; pct=100; adkim=r; aspf=r
Understanding DMARC policy: MailBreeze sets p=quarantine by default, which tells receiving servers to send suspicious emails to spam rather than rejecting them outright. This protects your deliverability while you’re building sender reputation. The rua and ruf parameters send DMARC reports to MailBreeze so we can monitor your domain’s authentication health.
6

Verify Your Records

Before clicking Check in MailBreeze, verify your records are live using MXToolbox DNS Lookup. Enter your full record name (e.g., _mailbreeze.mail.example.com) and confirm the values match what MailBreeze expects.
7

Complete Verification

Return to your MailBreeze dashboard and click Check to verify your DNS records. DNS propagation typically completes within a few minutes, but can take up to 72 hours in some cases.

​
After Verification

Once all 4 records show as verified, your domain is ready to send. You can:

​
Troubleshooting

Double-check the following:
  • Record values were copied exactly from MailBreeze (no extra spaces or missing characters)
  • You entered only the subdomain portion if your provider auto-appends the domain
  • TXT values are wrapped in quotes if your provider requires it (e.g., Route 53)
  • You’re adding records to the correct domain/subdomain
DNS propagation usually takes 5-15 minutes but can take up to 72 hours. To check propagation status:
  1. Use MXToolbox or WhatsMyDNS to verify records are visible globally
  2. If records appear in these tools but MailBreeze still shows pending, wait a few minutes and click Check again
This error indicates DNS records are being proxied. In Cloudflare, click the orange cloud icon next to each record to change it to gray (DNS only).
If verification is still pending after 72 hours:
  1. Use MXToolbox to verify records are visible
  2. Compare the visible records against what MailBreeze expects
  3. Contact support@mailbreeze.com with your domain name and we’ll investigate

​
Need Help?

Contact us at support@mailbreeze.com for assistance with domain verification.