Skip to content

email-deliverability-guide.md

Latest commit

 

History

History
197 lines (154 loc) · 4.97 KB

email-deliverability-guide.md

File metadata and controls

197 lines (154 loc) · 4.97 KB
Raw

📧 Email Deliverability Guide

This guide helps prevent your portfolio contact form emails from going to junk/spam folders.

🚨 Common Reasons Emails Go to Junk

1. From Address Issues

  • ❌ Using noreply@ addresses (spam trigger)
  • ❌ Generic sender names like "Portfolio Contact"
  • ❌ Mismatched domain names

2. Subject Line Problems

  • ❌ Excessive emojis (📧🙏💬)
  • ❌ ALL CAPS text
  • ❌ Spam trigger words: "Free", "Act Now", "Limited Time"

3. Content Issues

  • ❌ HTML-only emails (no text version)
  • ❌ Too many images or links
  • ❌ Poor HTML structure

4. Technical Issues

  • ❌ Missing email headers
  • ❌ No proper authentication
  • ❌ High sending volume from new domain

✅ Solutions Implemented

1. Improved From Address

// Before
from: 'Portfolio Contact <noreply@aswincloud.com>'

// After  
from: 'Aswin Portfolio <contact@aswincloud.com>'

2. Clean Subject Lines

// Before
subject: '📧 New Portfolio Contact from ${name}'
subject: '🙏 Thank you for contacting me!'

// After
subject: 'New Portfolio Contact from ${name}'
subject: 'Thank you for contacting me - Aswin Portfolio'

3. Added Email Headers

headers: {
  'X-Priority': '1',
  'X-MSMail-Priority': 'High', 
  'Importance': 'high',
  'X-Mailer': 'Aswin Portfolio Contact Form'
}

4. Added Reply-To Headers

// Admin email - reply goes to visitor
replyTo: email

// User email - reply goes to you
replyTo: process.env.CONTACT_EMAIL

5. Added Text Versions

  • Both HTML and text versions included
  • Improves deliverability significantly
  • Better accessibility

🔧 Additional Steps to Take

1. Domain Authentication

Set up these DNS records for aswincloud.com:

SPF Record

TXT @ "v=spf1 include:_spf.resend.com ~all"

DKIM Record

Resend will provide this when you verify your domain.

DMARC Record

TXT _dmarc "v=DMARC1; p=quarantine; rua=mailto:dmarc@aswincloud.com"

2. Verify Your Domain in Resend

  1. Go to Resend Dashboard
  2. Add aswincloud.com as a domain
  3. Follow the DNS setup instructions
  4. Wait for verification (can take 24-48 hours)

3. Warm Up Your Domain

  • Start with low volume (1-2 emails per day)
  • Gradually increase over 2-4 weeks
  • Monitor deliverability metrics

4. Monitor and Test

  • Check spam folder regularly
  • Use tools like Mail Tester
  • Monitor Resend analytics

📊 Best Practices

✅ Do's

  • Use a real person's name in From field
  • Include both HTML and text versions
  • Add proper headers and reply-to
  • Keep subject lines professional
  • Use your own domain for sending
  • Monitor bounce rates

❌ Don'ts

  • Use noreply@ addresses
  • Send HTML-only emails
  • Use excessive emojis in subjects
  • Send from free email providers
  • Ignore bounce reports

🛠️ Testing Your Setup

1. Test with Mail Tester

  1. Go to mail-tester.com
  2. Get a test email address
  3. Send a test email from your contact form
  4. Check your score (aim for 9-10/10)

2. Test with Different Email Providers

  • Gmail
  • Outlook/Hotmail
  • Yahoo
  • Apple Mail
  • Business email providers

3. Check Spam Score

Use tools like:

📈 Monitoring

Resend Analytics

Monitor these metrics in your Resend dashboard:

  • Delivery rate (should be >95%)
  • Bounce rate (should be <5%)
  • Spam complaints (should be <0.1%)

Manual Checks

  • Check spam folders regularly
  • Ask recipients to mark as "Not Spam"
  • Add your sending address to contacts

🚀 Advanced Tips

1. Domain Reputation

  • Keep your domain clean and professional
  • Avoid sending marketing emails from same domain
  • Use separate domains for different purposes

2. Content Quality

  • Write professional, helpful content
  • Avoid spam trigger words
  • Keep emails concise and relevant

3. Technical Setup

  • Use proper email authentication
  • Monitor DNS records regularly
  • Keep sending infrastructure updated

📞 Support

If emails are still going to junk after implementing these changes:

  1. Wait 24-48 hours for DNS changes to propagate
  2. Check Resend dashboard for any warnings
  3. Test with different email providers
  4. Contact Resend support if issues persist

🔄 Quick Checklist

  • Domain verified in Resend
  • SPF record added to DNS
  • DKIM record added to DNS
  • DMARC record added to DNS
  • Using professional From address
  • Clean subject lines (no excessive emojis)
  • Both HTML and text versions included
  • Proper headers added
  • Reply-to headers configured
  • Testing with multiple email providers
  • Monitoring deliverability metrics

Following this guide should significantly improve your email deliverability and reduce the chance of emails going to junk folders.