HomeTroubleshootingEmails Not Being Delivered

Emails Not Being Delivered

Diagnose and fix common email deliverability problems.

Check SPF and DKIM Records

The most common cause of emails landing in spam is missing DNS authentication records.

  1. Go to Settings > Email and check the Domain Health indicator.
  2. If it shows a warning, you need to add SPF and DKIM records to your domain's DNS settings.
  3. SPF record: Add a TXT record with the value provided on the settings page (e.g., v=spf1 include:sendgrid.net ~all).
  4. DKIM record: Add the CNAME or TXT record as specified by your email provider.

Spam Folder Issues

If recipients find your emails in spam:

  • Avoid using ALL CAPS or excessive exclamation marks in subject lines.
  • Keep your email content balanced between text and images. Emails with only images are flagged by spam filters.
  • Include an unsubscribe link in every broadcast (SteepleOS adds this automatically).

SMTP Connection Errors

If broadcasts fail with a connection error:

  1. Verify your SMTP credentials under Settings > Email.
  2. Confirm the SMTP port is correct (typically 587 for TLS or 465 for SSL).
  3. Some hosts block outbound SMTP. Check with your hosting provider if you are using custom SMTP.

Bounce Management

High bounce rates damage your sender reputation. SteepleOS automatically marks hard-bounced addresses and stops sending to them. Review bounced contacts under Communications > Health > Bounces and update or remove invalid addresses.

Was this article helpful?