Skip to content

[08], plugin 10: Subset Mail

Send your site's email through a real mail service

Send WordPress email through SMTP or your provider, with a log.

Subset Mail sends your site's email through SMTP or your email provider's API instead of PHP's mail function. It logs every message, so you can see who it went to, which mailer sent it and why it failed.

To install and update the free plugins from wp-admin, add the Subset Installer.

DocumentationChangelog

Requires
WP 6.5+ · PHP 8.1+
Tested to
WP 7.1
WP-CLI
Yes
REST
Yes
Multisite
Yes
Editions
Free + Pro

How Subset Mail works

API mailers send each email in one HTTPS request. SMTP sets up WordPress's own PHPMailer, so attachments, headers and multipart email work the way core handles them. A site that sends no email runs no extra queries.

The log has its own indexed table. It stores recipients, subject, mailer, status and any error, and keeps the message body only if you turn that on under Subset → Mail → Settings. Entries older than 30 days are deleted daily, along with the oldest beyond 50,000, and you can change both limits.

Failures go to Site Health, not admin notices. A send that failed in the last 24 hours shows as an issue with the error and a link to the log. When you open Site Health, it also looks up your sending domain's SPF and DMARC records.

On a staging copy, define( 'SUBSET_MAIL_DISABLE', true ); in wp-config.php stops every email before it's sent, and the log lists each one as blocked. Sending is never switched off for you: on a site that isn't production, Site Health warns that it's sending real email and names the constant.

What each version includes

Pro is a separate add-on that installs alongside the free plugin. Everything in the free list stays free.

Free

Full plugin

No time limit and no upgrade nags.

  1. SMTP with TLS or SSL
  2. Amazon SES, Postmark, Mailgun, SendGrid and Brevo APIs
  3. Email log with search, filters and resend
  4. Site Health reports for failed sends, SPF and DMARC
  5. Keys in wp-config.php, or encrypted in the database
  6. Import from WP Mail SMTP, FluentSMTP and Post SMTP
  7. A staging switch that blocks and logs every email
  8. Multisite, WP-CLI and a REST API

Pro

Add-on

Everything in Free, plus:

  1. Backup connection when the main mailer fails
  2. Routing rules by From address, recipient domain or plugin
  3. Failure alerts by email or webhook
  4. Log forwarding to a webhook or syslog
  5. Keep the log for up to a year, with CSV export
  6. One log for every site on a multisite network

Questions

Where should I put my password or API key?
In wp-config.php if you can, for example define( 'SUBSET_MAIL_POSTMARK_TOKEN', '…' );. Keys set there never touch the database, so they don't travel with a database export. Keys saved on the settings screen are encrypted with a key derived from your site's auth salt, so if you change your salts, enter your keys again.
Does the log store the content of my emails?
Not by default. It stores recipients, subject, status, the mailer used and any error. You can turn on body storage under Subset → Mail → Settings while you debug, then turn it off again. Resending an email needs its stored body.
Can I bring my settings from another mail plugin?
Yes, from WP Mail SMTP, FluentSMTP and Post SMTP, at the end of Subset → Mail → Settings. Their settings are read from the database, so the other plugin doesn't have to be active, and you see what will be imported before anything is saved.
What happens if my mail service is down?
The send fails, WordPress reports the failure to the plugin that sent the email, and the log records the error. The failure shows in Site Health for 24 hours. Subset Mail Pro can retry the email through a backup connection.
Does the plugin contact any external services?
Only the mail service you choose, and only to send email. It makes no other remote requests and collects no usage data.
Does it work on multisite?
Yes. Network activation sets up every site. The mailer and its connection are set once under Network Admin → Settings → Subset Mail, and each site keeps its own log and can use its own From address.
Will deleting the plugin delete my log?
No. Deleting the plugin keeps your settings and log, so reinstalling it picks up where you left off. To remove everything, turn on Delete all data on uninstall under Subset → Mail → Settings first.

Underneath

Every Subset plugin has WP-CLI commands and documented hooks and filters. It also has a REST API.

Read the developer reference

WP-CLI
$ wp subset mail test you@example.com
$ wp subset mail log list --status=failed
$ wp subset mail log resend 42

Hear about Subset Mail releases

We’ll email you when Subset Mail has a new release, and only about Subset Mail.

One confirmation email, then nothing until we have news. Unsubscribing takes one click and no account.

We will email you a confirmation link. Click it and you are on the list. Until then nothing is confirmed.