How to enable the email error log in wordpress

How to Enable the Email Error Log in WordPress

Editorial Note: We may earn a commission when you visit links on our website.

Do you want to check email error logs in WordPress?

By default, you can’t view email error logs in WordPress unless you know how to code in PHP.

Thankfully, there’s a much easier way to enable error logs for your emails in WordPress that requires no coding at all.

In this post, we’ll show you how to enable the email error log in WordPress the easy way.

Enable WordPress Email Error Log Now

Why Do You Need to Log Email Errors in WordPress?

Email error logs are important because they help you troubleshoot the exact issue preventing your emails from sending.

WordPress is notorious for email sending issues. But without an email error log, it’s not easy to determine the real cause of your email problems.

By default, WordPress doesn’t have a native email error logging system. However, you can use third-party plugins to track and log email errors for debugging purposes.

Below, we’ll show you how you can set up email error tracking in WordPress the simple way.

How to Enable the Email Error Log in WordPress

Enabling the email error log in WordPress is quite easy. We’ll guide you through the whole process.

Let’s begin.

1. Install WP Mail SMTP

To start with, you’ll need to install WP Mail SMTP on your site. This plugin will log your email errors (in case there are any).

WP Mail SMTP primarily works to solve your email issues, so you likely won’t have any errors after installing the plugin on your site.

However, things can always go wrong and it’s always a good idea to log email errors.

To install the plugin on your site, first get a WP Mail SMTP plan. When you’ve purchased one, go to your WP Mail SMTP account dashboard.

Here, click on the Downloads tab and then press the Download WP Mail SMTP button.

Download the WP Mail SMTP plugin

While the plugin zip file is downloading, you can also obtain your account license key from this page. You’ll need this license key later on in the setup.

WP Mail SMTP license

Once the zip file has finished downloading, go to your WordPress admin area. Then click on Plugins » Add New from the navigation menu on the left and press the Upload Plugin button.

Upload plugin in WordPress

Click on Choose File to open the file browser window. Then find and select the plugin zip file you just downloaded.

Install now WP Mail SMTP

The plugin should install within a few seconds. Click on the Activate Plugin button to activate it.

Activate plugin

The activation should launch the WP Mail SMTP Setup Wizard automatically.

But if it didn’t start by itself, you can go to WP Mail SMTP » Settings and then press the Launch Setup Wizard button.

Launch setup wizard

The Setup Wizard will guide you through the next steps.

2. Select a Mailer Service

For WP Mail SMTP to work, you need to connect your email account to a mailer service. The Setup Wizard makes this really easy.

When the wizard starts, click on Let’s Get Started.

click the Let's Get Started button

On the next screen, the wizard will require you to select a mailer.

Select your SMTP mailer

We recommend SendLayer because it is a high-end yet affordable mailer service that’s very easy to connect with WP Mail SMTP. Plus, you can start sending emails for free.

If you’re not sure which mailer you want to use, check out this guide on the best transactional mailer services.

After making your selection, click the doc guide link for the relevant mailer from the table below:

Mailers available in all versions Mailers in WP Mail SMTP Pro
SendLayer Amazon SES Microsoft 365 /
Brevo (formerly Sendinblue) Zoho Mail
Google Workspace / Gmail
Other SMTP

When you’re finished connecting your mailer with WP Mail SMTP, return to this post for the next step.

Want to set up multiple mailers? You can do so in the Additional Connections settings, then select a Backup Connection and configure Smart Routing.

3. Enable WordPress Email Error Log

In WP Mail SMTP, the email error log (or Debug Events) is enabled by default as soon as you set up the plugin on your site.

To confirm that it’s enabled, go to WP Mail SMTP » Tools and then select the Debug Events tab from the horizontal navigation menu.

Accessing the Debug Events tool

On this page, make sure that the Email Sending Errors option is enabled (it should be enabled by default).

The Email Sending Errors debug event type

The Email Sending Errors option tracks your emails for errors and maintains a log of these errors as they’re detected on your site over time.

If you’d like to get deeper into troubleshooting a particular email issue, you can also enable the Debug Email Sending option. When enabled, this option will record all kinds of email sending events rather than only logging errors.

Enabling the Debug Email Sending debug event type

This can be helpful if you can’t fix your emails and need more detailed information that you can share with your developer or our technical support for further assistance.

We advise against keeping the Debug Email Sending option enabled for long periods of time.

It’s more secure to only enable this feature when you’re facing a persistent email problem and disable it once the problem has been solved.

4. View WordPress Email Error Log

By default, WP Mail SMTP will display an alert message in your WordPress dashboard whenever it detects an email error event.

If you click the Error Event link in the debug notification, it will take you to the Debug Events page.

The error event link in an email sending error message

Another way to see the table of debug events is by navigating to WP Mail SMTP » Tools » Debug Events. You’ll find all event information on a table on the bottom of the page.

The Debug Events table

The Content column of each error event provides helpful context around the nature of the issue. Your developer should be able to fix the email error issue based on this information.

If you click on the Event#, it will expand into a box containing further details.

Viewing debug event details

If these error logs don’t make sense to you, feel free to send these over to our support team. We’ll find the solution you need to fix your WordPress email sending issues.

And that’s it! You now know how to enable email error log in WordPress to make potential errors easier to diagnose.

Next, Eliminate Contact Form Spam

Do you know that contact form spam is a fixable problem? See our guide on how to stop contact form spam for tips.

Also, you might want to check out our post on best WordPress SMTP plugins to see how WP Mail SMTP compares to other similar plugins.

Enable WordPress Email Error Log Now

Ready to fix your emails? Get started today with the best WordPress SMTP plugin. WP Mail SMTP Elite includes full White Glove Setup and offers a 14-day money-back guarantee.

If this article helped you out, please follow us on Facebook and Twitter for more WordPress tips and tutorials.

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our privacy policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.

This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.