Title: MazeSMTP
Author: mazewp
Published: <strong>November 18, 2026</strong>
Last modified: November 18, 2026

---

Search plugins

![](https://ps.w.org/maze-smtp/assets/banner-772x250.png?rev=3809911)

![](https://ps.w.org/maze-smtp/assets/icon-256x256.png?rev=3809911)

# MazeSMTP

 By [mazewp](https://profiles.wordpress.org/mazewp/)

[Download](https://downloads.wordpress.org/plugin/maze-smtp.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/maze-smtp/#description)
 * [Reviews](https://wordpress.org/plugins/maze-smtp/#reviews)
 *  [Installation](https://wordpress.org/plugins/maze-smtp/#installation)
 * [Development](https://wordpress.org/plugins/maze-smtp/#developers)

 [Support](https://wordpress.org/support/plugin/maze-smtp/)

## 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_options` capability.
   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) or `api.eu.mailgun.net` (EU region).
 * Provided by Mailgun Technologies, Inc.: [Terms of Service](https://www.mailgun.com/legal/terms/),
   [Privacy Policy](https://www.mailgun.com/legal/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 random `MAZE_SMTP_SECRET_KEY` of at least 32 characters in `wp-config.
   php` before saving connection credentials.
 * When the plugin is deleted, its data is kept.

## Screenshots

[⌊The dashboard: delivery rate, failures, retries and emails per day.⌉⌊The dashboard:
delivery rate, failures, retries and emails per day.⌉[

The dashboard: delivery rate, failures, retries and emails per day.

[⌊The email log: search and filter every message by status, connection and date.⌉⌊
The email log: search and filter every message by status, connection and date.⌉[

The email log: search and filter every message by status, connection and date.

[⌊Open a logged email to read its body, headers and each delivery attempt.⌉⌊Open
a logged email to read its body, headers and each delivery attempt.⌉[

Open a logged email to read its body, headers and each delivery attempt.

[⌊Connections: one sender per connection, with a default and a fallback.⌉⌊Connections:
one sender per connection, with a default and a fallback.⌉[

Connections: one sender per connection, with a default and a fallback.

[⌊Settings: sending order, simulation mode, log retention and AI tools.⌉⌊Settings:
sending order, simulation mode, log retention and AI tools.⌉[

Settings: sending order, simulation mode, log retention and AI tools.

## Installation

 1. Install and activate MazeSMTP from Plugins  Add New.
 2. Open MazeSMTP  Connections and add your SMTP server or Mailgun domain.
 3. 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.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“MazeSMTP” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ mazewp ](https://profiles.wordpress.org/mazewp/)

[Translate “MazeSMTP” into your language.](https://translate.wordpress.org/projects/wp-plugins/maze-smtp)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/maze-smtp/), check 
out the [SVN repository](https://plugins.svn.wordpress.org/maze-smtp/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/maze-smtp/) by [RSS](https://plugins.trac.wordpress.org/log/maze-smtp/?limit=100&mode=stop_on_copy&format=rss).

## 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.

## Meta

 *  Version **1.1.0**
 *  Last updated **7 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [email](https://wordpress.org/plugins/tags/email/)[email log](https://wordpress.org/plugins/tags/email-log/)
   [mailgun](https://wordpress.org/plugins/tags/mailgun/)[smtp](https://wordpress.org/plugins/tags/smtp/)
   [wp-mail](https://wordpress.org/plugins/tags/wp-mail/)
 *  [Advanced View](https://wordpress.org/plugins/maze-smtp/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/maze-smtp/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/maze-smtp/reviews/)

## Contributors

 *   [ mazewp ](https://profiles.wordpress.org/mazewp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/maze-smtp/)