Fix Email Delivery Issues

Troubleshoot why emails aren’t being sent or received.

Test Email Sending

First, verify if emails work at all:

  1. Go to Customer History → Email Templates
  2. Click Send Test Email
  3. Enter your email address
  4. Click Send
  5. Check inbox (and spam folder)

Common Causes

SMTP Not Configured

WordPress default mail() function may not work on all hosts.

Solution: Install SMTP plugin:

  • WP Mail SMTP (recommended)
  • Easy WP SMTP
  • Post SMTP

Configure with your email provider’s SMTP details.

Email Blocked by Host

Some hosts block outgoing emails.

Solution:

  • Contact hosting support
  • Ask them to enable email sending
  • Or use SMTP with external provider

Invalid Email Addresses

Check recipient addresses are correct:

  • No typos in email addresses
  • Valid email format
  • Domain exists and has MX records

Template Errors

Broken email template:

  • Reset template to default
  • Check for HTML errors
  • Test with simple plain text first

Check Email Logs

View send history:

  1. Go to Customer History → Tools → Email Logs
  2. See all sent emails
  3. Check status (sent, failed, pending)
  4. View error messages if any

Spam Folder Issues

Emails going to spam:

  • Use proper From address (not no-reply@)
  • Configure SPF and DKIM records
  • Use reputable SMTP provider
  • Avoid spammy words in subject
  • Include unsubscribe link

Configure SMTP

Using WP Mail SMTP:

  1. Install WP Mail SMTP plugin
  2. Go to plugin settings
  3. Choose provider (Gmail, SendGrid, etc.)
  4. Enter credentials/API key
  5. Send test email
  6. Verify delivery

Alternative: Transactional Email Service

Use dedicated email service:

  • SendGrid: 100 free emails/day
  • Mailgun: Good deliverability
  • Amazon SES: Very affordable
  • Postmark: Fast delivery

Check WooCommerce Emails

If WooCommerce emails also not working:

  • Problem is WordPress-wide
  • Not specific to Customer History
  • Fix WordPress email configuration

Notification Settings

Verify notifications enabled:

  1. Go to Settings → Notifications
  2. Check desired notifications are ON
  3. Verify recipient emails correct
  4. Save settings

Contact Support

If still not working, provide support with:

  • Email log screenshots
  • Error messages
  • SMTP configuration (hide passwords)
  • Hosting provider name
  • WordPress and PHP versions