### [How to Enable the Email Error Log in WordPress](https://wpmailsmtp.com/how-to-enable-email-error-log-in-wordpress/)

**Published:** May 18, 2022
**Author:** Osama Tahir

**Excerpt:** Facing email problems but not sure how to diagnose them? 

You need an email error log to help you with that. Sadly, WordPress doesn't have a built-in email debugging log but you can add one to your dashboard really easily. 

See this post to learn how you can enable email error logs in WordPress.

**Content:**

WordPress doesn’t include an email error log by default. Without one, diagnosing sending failures means guessing at the cause or writing custom PHP code.

WP Mail SMTP adds this capability without any coding. The steps below show you how to enable it, read what it captures, and set up failure alerts.

[Enable WordPress Email Error Log Now](https://wpmailsmtp.com/pricing/)

### 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. Without an error log, diagnosing the cause means guessing.

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

Getting errors resolved quickly matters more now than it used to. Since November 2025, Gmail permanently rejects problematic mail with a 550 error rather than deferring it temporarily, and Microsoft has enforced the same since May 2025. A sending error won’t self-resolve if left unnoticed.

## How to Enable the Email Error Log in WordPress

We’ll guide you through the whole process.

- [1. Install WP Mail SMTP](#aioseo-1-install-wp-mail-smtp)
- [2. Select a Mailer Service](#aioseo-2-select-a-mailer-service)
- [3. Enable WordPress Email Error Log](#aioseo-3-enable-wordpress-email-error-log)
- [4. View WordPress Email Error Log](#aioseo-4-view-wordpress-email-error-log)
- [5. (Optional) Enable Email Failure Alerts](#aioseo-5-optional-enable-email-failure-alerts)
- [FAQs About Email Error Logs in WordPress](#aioseo-faqs-about-email-error-logs-in-wordpress-101)

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](https://wpmailsmtp.com/pricing/). When you’ve purchased one, go to your [WP Mail SMTP account dashboard](https://wpmailsmtp.com/account/).

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

![Download the WP Mail SMTP plugin](https://wpmailsmtp.com/wp-content/uploads/2021/05/download-wp-mail-smtp.png)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](https://wpmailsmtp.com/wp-content/uploads/2019/07/wp-mail-smtp-license-key-1.png)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](https://wpmailsmtp.com/wp-content/uploads/2019/06/Upload-plugin-in-WordPress.jpg)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](https://wpmailsmtp.com/wp-content/uploads/2021/05/install-wp-mail-smtp.png)The plugin should install within a few seconds. Click on the **Activate Plugin** button to activate it.

![Activate plugin](https://wpmailsmtp.com/wp-content/uploads/2019/07/add-new-plugin-activate.png)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](https://wpmailsmtp.com/wp-content/uploads/2021/03/Launch-setup-wizard.png)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 walks you through it.

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

![click the Let's Get Started button](https://wpmailsmtp.com/wp-content/uploads/2021/05/wp-mail-smtp-setup-wizard.png)On the next screen, the wizard will require you to select a mailer.

![Select your SMTP mailer](https://wpmailsmtp.com/wp-content/uploads/2021/06/SMTP-Email-Setup-Brevo.png)We recommend SendLayer as a reliable and affordable mailer that connects with WP Mail SMTP in a few minutes.

If you’re not sure which mailer you want to use, check out this guide on the [best transactional mailer services](https://wpmailsmtp.com/transactional-email-providers/).

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

Mailers available in all versionsMailers in [WP Mail SMTP Pro](https://wpmailsmtp.com/pricing/)[SendLayer](https://wpmailsmtp.com/docs/how-to-set-up-the-sendlayer-mailer-in-wp-mail-smtp/)[Amazon SES](https://wpmailsmtp.com/docs/how-to-set-up-the-amazon-ses-mailer-in-wp-mail-smtp/)[SMTP.com](https://wpmailsmtp.com/docs/how-to-set-up-the-smtp-com-mailer-in-wp-mail-smtp/)[Microsoft 365 / Outlook.com](https://wpmailsmtp.com/docs/how-to-set-up-the-outlook-mailer-in-wp-mail-smtp/)[Brevo](https://wpmailsmtp.com/docs/how-to-set-up-the-sendinblue-mailer-in-wp-mail-smtp/)[Zoho Mail](https://wpmailsmtp.com/docs/how-to-set-up-the-zoho-mailer-in-wp-mail-smtp/)[Google Workspace / Gmail](https://wpmailsmtp.com/docs/how-to-set-up-the-gmail-mailer-in-wp-mail-smtp/)[Mailjet](https://wpmailsmtp.com/docs/how-to-set-up-the-mailjet-mailer-in-wp-mail-smtp/ "Mailjet")[Mailgun](https://wpmailsmtp.com/docs/how-to-set-up-the-mailgun-mailer-in-wp-mail-smtp/)[Postmark](https://wpmailsmtp.com/docs/how-to-set-up-the-postmark-mailer-in-wp-mail-smtp/)[SendGrid](https://wpmailsmtp.com/docs/how-to-set-up-the-sendgrid-mailer-in-wp-mail-smtp/)[SMTP2GO](https://wpmailsmtp.com/docs/how-to-set-up-the-smtp2go-mailer-in-wp-mail-smtp/ "SMTP2GO")[SparkPost](https://wpmailsmtp.com/docs/how-to-set-up-the-sparkpost-mailer-in-wp-mail-smtp/)[Elastic Email](https://wpmailsmtp.com/docs/how-to-set-up-the-elastic-email-mailer-in-wp-mail-smtp/)[Other SMTP](https://wpmailsmtp.com/docs/how-to-set-up-the-other-smtp-mailer-in-wp-mail-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](https://wpmailsmtp.com/docs/configuring-additional-connections/) settings, then select a [Backup Connection](https://wpmailsmtp.com/docs/configuring-backup-connection/) and configure [Smart Routing](https://wpmailsmtp.com/docs/setting-up-smart-email-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](https://wpmailsmtp.com/wp-content/uploads/2021/07/access-debug-events.png)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](https://wpmailsmtp.com/wp-content/uploads/2021/07/debug-events-email-sending-error.png)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](https://wpmailsmtp.com/wp-content/uploads/2021/07/debug-event-debug-email-sending.png)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](https://wpmailsmtp.com/contact/) 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](https://wpmailsmtp.com/wp-content/uploads/2021/07/email-sending-error-message.png)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](https://wpmailsmtp.com/wp-content/uploads/2021/07/debug-events-table.png)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](https://wpmailsmtp.com/wp-content/uploads/2021/07/debug-event-details.png)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](https://wpmailsmtp.com/wordpress-not-sending-email/).

### 5. (Optional) Enable Email Failure Alerts

With [Email Failure Alerts](https://wpmailsmtp.com/how-to-get-alerts-when-wordpress-emails-fail/), you’ll know the moment a message can’t be delivered, so you can fix the issue before it causes bigger problems.

In **WP Mail SMTP**, go to **Settings » Alerts** and choose the channels you want to use:

- **Email**
- **Slack**
- **Discord**
- **Microsoft Teams**
- **SMS** via Twilio
- **Webhooks** (for custom workflows)
- **Push notifications**
- **WhatsApp**

![Email Failure Alerts](https://wpmailsmtp.com/wp-content/uploads/2023/09/wpmailsmtp-screenshot-04-alerts2x-934x1024.png)Once enabled, WP Mail SMTP will send you an instant notification whenever an email fails to send.

**Pro tip:** These alerts use a secure API connection, so they’ll still reach you **even if your WordPress site can’t send emails at all**.

Click **Test Alerts** after setup to confirm everything’s working, and you’re done.

![](https://wpmailsmtp.com/wp-content/uploads/2025/06/test-alerts-button-1-1024x335.png)And that’s it! You now know how to enable email error log in WordPress to make potential errors easier to diagnose.

### FAQs About Email Error Logs in WordPress

Here are some of the most common questions we receive about logging email errors in WordPress.

#### Does WordPress have a built-in email error log?

No. WordPress core does not include an email error log feature. To track sending issues, you’ll need a plugin like WP Mail SMTP, which records email errors through its **Debug Events** feature (enabled by default).

#### **What’s the difference between Debug Events and Email Logs in WP Mail SMTP?**

**Debug Events** (available in the Lite version) record email sending errors and related events, helping you troubleshoot issues quickly. **Email Logs** (Pro feature) record the content, subject line, headers, attachments, and delivery status for every email sent.

#### How do Email Failure Alerts work?

Alerts notify you the moment an email can’t be sent. WP Mail SMTP supports multiple channels — Email, Slack, Discord, Microsoft Teams, SMS via Twilio, Webhooks, Push, and WhatsApp — so you can choose what works best.

#### Will I still get alerts if my site can’t send emails?

Yes. Email Failure Alerts use a secure API connection, meaning notifications can still be delivered even if your WordPress site itself is unable to send messages.

### 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](https://wpmailsmtp.com/how-to-stop-contact-form-spam-in-wordpress/) for tips.

Also, you might want to check out our post on [best WordPress SMTP plugins](https://wpmailsmtp.com/best-wordpress-smtp-plugins/) to see how WP Mail SMTP compares to other similar plugins.

[Enable WordPress Email Error Log Now](https://wpmailsmtp.com/pricing/)

**Categories:** WordPress Tutorials

**Tags:** debug events, email error, WP Mail SMTP

---