Prompt
How do I troubleshoot email delivery issues?
Latest observation
Here’s a practical way to troubleshoot email delivery issues, from simplest to most technical.
1) Confirm the symptom
Figure out where the failure is happening:
- Not sent: the message never left your app/server
- Sent but not received: recipient never got it
- Delivered to spam/junk: message arrived but not inbox
- Delayed: it arrives much later than expected
- Only some recipients fail: likely domain/provider-specific filtering
2) Check the basics first
- Verify the recipient address is correct
- Make sure the sender address/domain is valid
- Check if the mailbox is full or disabled
- Try sending to a different provider:
- Gmail
- Outlook/Hotmail
- Yahoo
- A work domain
If it works for some but not others, the issue is often authentication, reputation, or filtering.
3) Inspect bounces and error codes
If you’re using an email service provider or mail server, look at:
- SMTP response codes
- Bounce messages
- Event logs
Common categories:
- 5xx errors = permanent failure
- 4xx errors = temporary failure/retry later
Examples:
550/554: rejected by recipient server, often spam or policy-related421/451: temporary deferral
4) Verify authentication
Modern mail delivery depends heavily on authentication.
Check these DNS records:
- SPF: authorizes which servers can send mail for your domain
- DKIM: cryptographically signs messages
- DMARC: tells receivers how to handle failures and provides reporting
Problems to look for:
- Missing SPF record
- SPF includes too many sources or exceeds DNS lookup limits
- DKIM signature invalid or not aligned
- DMARC policy too strict before SPF/DKIM are correctly set up
- From domain doesn’t align with authenticated domain
5) Check sender reputation
Even valid mail can be blocked if your IP or domain reputation is poor.
Common causes:
- High spam complaints
- Sending to old/unverified lists
- Too many bounces
- Sudden volume spikes
- Shared IP reputation issues
- Past abuse or blacklisting
Actions:
- Reduce volume temporarily
- Warm up new IPs/domains gradually
- Remove inactive or invalid addresses
- Use double opt-in for marketing lists
6) Review content and formatting
Spam filters inspect message content.
Watch for:
- Spammy subject lines
- Too many links
- URL shorteners
- Image-only emails
- Broken HTML
- Mismatched link domains
- Attachments that trigger filters
- Missing plain-text version
Try sending a simple test email with:
- Plain subject
- Minimal body text
- One link or no links
- No attachments
7) Check IP/domain blacklists
Your sending IP or domain may be listed on DNS-based blocklists.
Use:
- MXToolbox blacklist checks
- Talos Intelligence
- Spamhaus checks
If listed:
- Identify why
- Fix the root cause
- Request delisting if appropriate
8) Validate DNS and mail server setup
For self-hosted mail:
- Ensure MX records are correct
- Reverse DNS (PTR) matches your sending host
- HELO/EHLO name is valid
- TLS certificates are valid
- Port 25/587/465 connectivity is working
- Outbound mail isn’t blocked by your ISP/cloud provider
9) Test end-to-end
Send test messages and inspect:
- SMTP transaction logs
- Message headers
- Delivery status notifications
- Spam folder placement
Useful header fields:
ReceivedAuthentication-ResultsDKIM-SignatureReturn-PathMessage-ID
These help identify whether the message was authenticated and which server handled it.
10) Ask the recipient side
If one recipient domain is rejecting mail:
- Ask their mail admin to check logs
- Provide full headers and bounce messages
- Ask whether your IP/domain is blocked
- Confirm whether a mail gateway or security filter is in front of the mailbox
11) If you use a provider, check their dashboard
Services like SendGrid, SES, Mailgun, Postmark, etc. often provide:
- Delivery events
- Suppression lists
- Complaint tracking
- Bounce reasons
- Reputation metrics
Make sure the address isn’t on a:
- Suppression list
- Unsubscribe list
- Bounce list
12) Common quick fixes
- Fix SPF/DKIM/DMARC
- Remove bad recipients
- Lower send volume
- Improve content
- Use a reputable sending domain
- Switch from shared IP to dedicated IP if needed
- Enable proper reverse DNS and TLS
- Ask recipients to whitelist you if appropriate
A simple troubleshooting flow
- Send to a few test addresses at different providers
- Check bounce/error logs
- Verify SPF/DKIM/DMARC
- Inspect content and reputation
- Check blacklists and suppression lists
- Validate DNS and server setup
- Escalate with full headers and logs
If you want, I can also give you:
- a step-by-step checklist for Gmail/Outlook delivery issues
- a self-hosted mail server troubleshooting guide
- or help analyze a specific bounce message or header.