> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wpstratos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WP Postman Email Logs: View Delivery History and Errors

> Learn how to read WP Postman's email logs to verify delivery, diagnose failed messages, and troubleshoot your SMTP configuration quickly.

WP Postman records every email your WordPress site attempts to send, whether it succeeds or fails. The Email Logs screen gives you a timestamped, searchable history of all outbound messages — complete with the recipient address, subject line, delivery status, and the full message body. When something goes wrong with email delivery, the logs are the fastest way to identify whether the problem is with your SMTP credentials, your server connection, or the recipient's mail server.

## Accessing Email Logs

<Steps>
  <Step title="Open the WordPress admin dashboard">
    Log in to your site's WordPress admin area at `/wp-admin`.
  </Step>

  <Step title="Navigate to WP Postman">
    Click **WP Postman** in the left-hand sidebar menu.
  </Step>

  <Step title="Click Email Logs">
    Select **Email Logs** from the WP Postman submenu. The full log table loads immediately, sorted by most recent first.
  </Step>
</Steps>

## Understanding the Log Table

Each row in the log table represents a single outbound email attempt. The columns are:

| Column          | Description                                                                                                                                    |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date / Time** | The exact timestamp when WP Postman attempted to send the message, displayed in your site's configured timezone.                               |
| **Recipient**   | The `To:` address the email was addressed to. For messages sent to multiple recipients, each address appears on its own line within the cell.  |
| **Subject**     | The subject line of the email exactly as it was passed to `wp_mail()`.                                                                         |
| **Status**      | **Sent** (shown in green) if the SMTP server accepted the message, or **Failed** (shown in red) if the send attempt was rejected or timed out. |
| **Action**      | A **View** button that opens the full details for that log entry, including headers, body, and any error message returned by the SMTP server.  |

## Viewing a Log Entry

<Steps>
  <Step title="Locate the entry you want to inspect">
    Find the message in the log table by scanning the Recipient or Subject columns, or use your browser's find-in-page to search for a specific address.
  </Step>

  <Step title="Click the View button">
    Click the **View** button in the Action column for that row. A detail panel opens.
  </Step>

  <Step title="Review the message details">
    The detail panel shows the complete email headers (From, To, CC, Reply-To), the full HTML or plain-text message body, and — for failed messages — the error response returned by the SMTP server. Copy this error text when contacting your SMTP provider's support team.
  </Step>
</Steps>

## Diagnosing Failed Emails

When a log entry shows a **Failed** status, the error message in the detail panel points to the root cause. Use the accordion below to match the error to a fix.

<Accordion title="Authentication failed">
  The SMTP server rejected your username or password. Double-check both fields in **WP Postman → SMTP Settings**. If you are using Gmail, remember that your regular Google account password does not work here — you must generate and use a dedicated **App Password** with 2FA enabled on your Google account. For other providers, verify that the credential you are using has not been rotated or revoked in your provider's dashboard.
</Accordion>

<Accordion title="Connection refused">
  WP Postman could not establish a TCP connection to the SMTP host. Confirm the hostname is spelled correctly and that the port number matches the encryption setting you have chosen (587 for TLS, 465 for SSL). On some network configurations a firewall rule on the server blocks outbound SMTP connections — if you suspect this, contact WP Stratos support to confirm whether outbound connections on your chosen port are permitted.
</Accordion>

<Accordion title="TLS handshake error">
  The server connected but failed to negotiate a secure channel. This usually means there is a mismatch between the encryption setting in WP Postman and what the remote server expects. Try switching the Encryption setting between **TLS** and **SSL**, or temporarily set it to **None** to isolate whether the issue is with the encryption negotiation itself. Re-enable encryption once the connection is confirmed working.
</Accordion>

<Accordion title="Recipient rejected">
  Your SMTP server accepted the message and attempted delivery, but the recipient's mail server refused it. This is outside WP Postman's control and is typically caused by the recipient's domain having strict spam filters, a full mailbox, or a policy that blocks messages from your sending domain. Check that your From Email address is on a domain with valid SPF, DKIM, and DMARC records published in DNS. Your SMTP provider's dashboard may show additional bounce details.
</Accordion>

<Info>
  Email logs are retained for **30 days** and then automatically deleted. If you need to keep a longer-term record of email activity, export or copy relevant log entries before they age out.
</Info>

<Tip>
  Any time you update your SMTP settings, send a test email immediately and then open the Email Logs to confirm the new settings produced a **Sent** status. This habit catches misconfigured credentials before your users run into a broken password-reset or order-confirmation flow.
</Tip>


## Related topics

- [Diagnose and Fix Email Delivery Problems in WP Postman](/troubleshooting/email-delivery.md)
- [Configure Your SMTP Provider Settings in WP Postman](/plugins/wp-postman/smtp-configuration.md)
- [WP Postman: Reliable SMTP Email for Your WordPress Site](/plugins/wp-postman/overview.md)
- [WP Stratos: Get Your WordPress Site Live in Minutes](/quickstart.md)
- [Introduction to WP Stratos Managed WordPress Hosting](/introduction.md)
