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)
- Go to Plugins → Add New in your WordPress admin.
- Search for “Mailtric”.
- Click Install Now, then Activate.
- 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
- Download the Mailtric ZIP from WordPress.org.
- Upload the ZIP under Plugins → Add New → Upload Plugin, or extract it to
/wp-content/plugins/mailtric. - Activate Mailtric from the Plugins screen.
First-time setup
- Open Mailtric → Settings.
- Logging – Ensure logging is enabled and choose whether to store successes, failures, and full content/headers.
- SMTP (optional) – Enter host, port, username, password, and encryption if you want Mailtric to handle sending.
- Email Test – Send a test email to confirm WordPress can send mail.
- SMTP Test – Verify connectivity and authentication to your SMTP provider.
- Deliverability Check – Inspect SPF, DKIM, DMARC, MX, and blacklist status to catch domain issues early.
- Data Retention – Turn on retention and set the maximum logs to keep your database lean.
- Security & Roles – Require authentication and pick which WordPress roles can access Mailtric.
Verify logging
- Trigger an email (e.g., password reset) or send an Email Test.
- Go to Mailtric → Email Logs to confirm the entry appears with the correct status.
- Use filters (subject, recipient, date, status) to locate the message.
- 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.