Documentation

Explore the guides & API reference

Installation & Setup

Install Mailtric so you can start logging every WordPress email and diagnosing deliverability issues.

Requirements

Minimum versions

  • WordPress 5.6 or higher (tested up to 6.9)
  • PHP 8.0 or higher
  • Ability to send email from your server or SMTP provider credentials

Install from the WordPress dashboard (recommended)

  1. Go to Plugins → Add New in your WordPress admin.
  2. Search for “Mailtric”.
  3. Click Install Now, then Activate.
  4. Mailtric adds a menu item in your admin sidebar.

You're ready to log emails

Once activated, Mailtric immediately logs emails sent via wp_mail() and exposes the Email Tools and Settings pages.

Manual installation

  1. Download the Mailtric ZIP from WordPress.org.
  2. Upload the ZIP under Plugins → Add New → Upload Plugin, or extract it to /wp-content/plugins/mailtric.
  3. Activate Mailtric from the Plugins screen.

First-time setup

  1. Open Mailtric → Settings.
  2. Logging – Ensure logging is enabled and choose whether to store successes, failures, and full content/headers.
  3. SMTP (optional) – Enter host, port, username, password, and encryption if you want Mailtric to handle sending.
  4. Email Test – Send a test email to confirm WordPress can send mail.
  5. SMTP Test – Verify connectivity and authentication to your SMTP provider.
  6. Deliverability Check – Inspect SPF, DKIM, DMARC, MX, and blacklist status to catch domain issues early.
  7. Data Retention – Turn on retention and set the maximum logs to keep your database lean.
  8. Security & Roles – Require authentication and pick which WordPress roles can access Mailtric.

Verify logging

  1. Trigger an email (e.g., password reset) or send an Email Test.
  2. Go to Mailtric → Email Logs to confirm the entry appears with the correct status.
  3. Use filters (subject, recipient, date, status) to locate the message.
  4. Click Resend if you want to retry a failed or bounced email.

Troubleshooting basics

  • Nothing appears in the log – Make sure the email is sent via wp_mail() and that logging is enabled.
  • SMTP test fails – Double-check host, port, encryption (TLS/SSL), username, and password; verify the firewall allows outbound SMTP.
  • Mail volume is high – Enable Data Retention and clean old logs; adjust batch size and rate limits under Performance.
  • Access issues – Confirm the current user role is allowed in Security & Roles and that authentication is required for viewing logs.

Next steps

  • Follow the Quick Start to log and resend your first emails.
  • Review Tools & Settings to understand everything that ships with Mailtric.
  • Check the FAQ for common questions about logging and deliverability.

Need Help?

Can't find what you're looking for? We're here to help you get the most out of Mailtric.