Mail Health

Checks whether email from your site will reach people's inboxes, and explains how to fix each problem in plain words.

Drupal reports an email as sent once the mail system accepts it, even when the receiving server later rejects it or files it as spam. Password resets, contact form messages and notifications go missing, and nobody notices until users complain. Until now the only way to check was an outside tool such as mail-tester.com.

Features

• One page of checks at Configuration » System » Mail health. Each check says what it found and how to fix it.
• Test email: send a test email to any address, or the real password reset email to yourself, and see whether the mail system accepted it. If it failed, you see why.
• Failure log: every email that failed to send, with the reason from the mail system.
• Status report: a Mail delivery line sums up the results.
• Extensible: other modules add their own checks with a tagged service.

The checks

• From address: the site has an email address, and it is not on a free mailbox provider such as Gmail or Yahoo, which no other server may send for.
• Mail transport: finds email that goes nowhere, such as the test mail collector left behind by a copied database, the null transport, or a mail plugin that no longer exists.
• SPF record: exactly one record, no +all, and no more than the 10 DNS lookups receivers allow, counting every include:.
• DKIM signature: a key is published under your provider's selector, and it is long enough.
• DMARC policy: a valid record exists. Gmail, Yahoo and Microsoft require one from domains that send a lot of email.
• Webform senders: no webform sends email from the visitor's own address, which fails DMARC.
• Failed sends: how many emails failed in the last 7 days.

Privacy

The log keeps the recipient's address only for emails that failed, and deletes old rows on cron (30 days by default). It can be turned off. The DNS checks only query the server's own DNS resolver. Nothing is sent to any other service.

Requirements

• Drupal 11.3 or later, or Drupal 12
• PHP 8.3 or later
• No other modules needed

Similar projects

Modules such as SMTP Authentication Support and Symfony Mailer change how mail is sent. Mail Health checks whether it will arrive, and works alongside any of them.