Description
MazeSMTP takes over the email your site sends with wp_mail() and delivers it through a connection you choose. Every message is logged with its headers, its body and what happened on each try.
Connections
- SMTP: any SMTP server, with STARTTLS, SSL/TLS or no encryption, with or without a login.
- Mailgun: Mailgun’s HTTP API, US or EU region. Useful where the host blocks SMTP ports.
- PHP mail: the server’s own
mail()function, as WordPress uses by default.
Each connection sends as exactly one sender address. A message whose From matches a connection’s sender goes through that connection; everything else goes through the default connection.
Delivery you can rely on
- When an attempt fails for a temporary reason (the server cannot be reached, a login is refused, a rate limit), MazeSMTP tries up to three more times: the fallback connection at once, then after 5 and 15 minutes (without a fallback: after 1, 5 and 15 minutes). No message gets more than four tries.
- Refused recipients and rejected content fail at once, because trying again would not help.
- A message is never lost because a page request stopped mid-send: the next run of WP-Cron picks it up.
- Simulation mode logs every message and sends nothing, for staging sites and tests.
Email log
- Search and filter by status, connection and date.
- Each message shows its sender, recipients, the plugin or theme that sent it, MIME headers with credential-like values masked, the HTML body (shown in a sandbox that blocks scripts and remote images) and every attempt, including the SMTP conversation or the Mailgun reply.
- Delete one message, a selection, everything matching a filter, or everything. Old messages are deleted automatically after the number of days you choose.
AI abilities (optional, off by default)
On WordPress 6.9 or later, MazeSMTP can register its tools with the WordPress Abilities API so that compatible AI integrations can use them. Turn it on under MazeSMTP → Settings → “Enable AI abilities”.
- Read-only abilities list your connections with their health (no credentials are returned), list the email log with masked recipients, and explain why a message failed.
- A separate switch, “Allow test emails”, adds one action: sending a test email through a connection, limited to one per connection per minute.
- Every ability requires a signed-in user with the
manage_optionscapability. While the setting is off, MazeSMTP registers nothing with the Abilities API.
External services
MazeSMTP sends email only through the connections you set up. It contacts no other service: no tracking, no usage statistics, no remote fonts or scripts.
Mailgun (only when you add a Mailgun connection)
- What it is: Mailgun’s email API, used to deliver your site’s email.
- When: every time an email is sent through that connection, including test emails and retries.
- What is sent: the complete email (sender, recipients including Bcc, subject, headers, body and attachments) and your Mailgun API key for authentication. It is sent to
api.mailgun.net(US region) orapi.eu.mailgun.net(EU region). - Provided by Mailgun Technologies, Inc.: Terms of Service, Privacy Policy.
Your SMTP server (only when you add an SMTP connection)
The complete email and the login you entered are sent to the SMTP server you configure, under that provider’s own terms.
Privacy
The email log is stored in your site’s database. Message content is sent only to the SMTP server or Mailgun connection you configure.
- The log keeps each message’s sender, recipients, subject, headers and body. Password-reset links, activation keys, credential-like headers and similar known secrets are masked in the log; the email that is sent is not changed.
- While a temporary failure is waiting to be retried, the original message is held in the database so MazeSMTP can resend it unchanged. This retry payload is removed when the message reaches a final state; the separately stored log body is redacted.
- Logs are deleted after 30 days by default (Settings → Keep logs for). You can also delete them at any time from the Email log.
- SMTP passwords and Mailgun API keys are encrypted using secret material from
wp-config.php; a database-only dump does not contain the encryption key. If the site’s WordPress keys are missing or are still the default placeholders, define a randomMAZE_SMTP_SECRET_KEYof at least 32 characters inwp-config.phpbefore saving connection credentials. - When the plugin is deleted, its data is kept.
Installation
- Install and activate MazeSMTP from Plugins → Add New.
- Open MazeSMTP → Connections and add your SMTP server or Mailgun domain.
- Use “Send a test” to check that it works.
Until you add a connection, email keeps going out through PHP mail as before, and it is logged.
FAQ
Does MazeSMTP replace wp_mail()?
No. It uses WordPress’s pre_wp_mail filter, so wp_mail() stays WordPress’s own, and the wp_mail_from, wp_mail_content_type, phpmailer_init and related hooks still run for every message.
Why does it say “delivered” when the email never arrived?
“Delivered” means the server or Mailgun accepted the message. What happens after that (spam filtering, the recipient’s mailbox) is outside your site. With PHP mail it means only that the server’s mail() function accepted it.
Retries do not run on my site.
Retries run on WP-Cron, which runs when someone visits the site. If DISABLE_WP_CRON is set, make sure a real cron job calls wp-cron.php.
I changed my site’s security keys and a connection stopped working.
Stored passwords and API keys are encrypted with those keys. Open the connection and enter the password or key again. To keep them readable across key changes, define MAZE_SMTP_SECRET_KEY in wp-config.php before you save them.
Screenshots





Changelog
1.1.0
- Improved the email dashboard with clearer delivery metrics and a WordPress.org review prompt.
- Improved the admin app shell, scrolling, and responsive navigation.
- Improved email-log detail review with a compact dialog and bounded, scrollable content tabs.
1.0.0
- Added SMTP delivery with STARTTLS, SSL/TLS or no encryption, and optional authentication.
- Added Mailgun HTTP API delivery for US and EU regions, plus PHP mail delivery.
- Added sender-based connection routing with configurable default and fallback connections.
- Added automatic retries for temporary failures, with WP-Cron recovery and up to four delivery attempts.
- Added simulation mode to log messages without sending them.
- Added searchable and filterable email logs with per-attempt details and a sandboxed HTML preview.
- Added controls to delete individual, selected, filtered, or all log entries, with configurable log retention.
- Added test email sending from the Connections screen.
- Added encrypted storage for SMTP passwords and Mailgun API keys.
- Added optional WordPress Abilities API integration (off by default), with a separate switch for the rate-limited test email.
