WP Manifestindependent plugin directory
manifest / email / wp-mail-inspector

WP Mail Inspector

WP Mail Inspector is a WordPress plugin that logs and monitors all actions related to the wp_mail() function. It helps developers debug email issues, track outgoing messages, and identify failures in real time. Built based on practical experience with WordPress email handling. Feel free to use and adapt it to your needs.

by Logic Net - Michał Bryja · github.com/bryjax76/wp-mail-inspector

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/bryjax76/wp-mail-inspector/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/bryjax76/wp-mail-inspector ↗

WP Mail Inspector is a lightweight WordPress plugin that logs all outgoing emails sent via wp_mail().

Features

  • Logs all emails sent via WordPress
  • Tracks status: sent / failed
  • Stores logs in a dedicated database table
  • Admin panel with table view
  • Expandable message and error fields
  • Clean and performant architecture

Preview

Message

How It Works

The plugin hooks into:

  • wp_mail – captures outgoing emails
  • wp_mail_failed – logs failed emails

It does NOT guarantee email delivery, only that WordPress attempted to send the email.

Installation

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate the plugin in WordPress admin
  3. Navigate to Mail Inspector in admin menu

Database

Creates a custom table: wp_wmi_logs

Stores:

  • status
  • recipient
  • subject
  • message
  • headers
  • error (if any)
  • timestamp

Admin UI

  • Table view of latest logs
  • Status highlighting (green/red)
  • Expandable message and error fields

Limitations

  • Only logs emails sent via wp_mail()
  • Cannot confirm actual delivery to inbox

Future Improvements

  • Filters and search
  • Pagination
  • Detailed view modal
  • Retry email feature

License

MIT