Understanding Mail Delivery Reports in WHM

Updated: 30 May 2024
WHM Version: 112


In this tutorial, we will explore how to use Mail Delivery Reports in WHM (Web Host Manager). As a useful feature of cPanel, Mail Delivery Reports help you monitor and troubleshoot email delivery issues. With an easy-to-understand interface, you can quickly find information on every email sent through your server.

Accessing Mail Delivery Reports

Let's begin by accessing the Mail Delivery Reports in WHM.

  1. First, log into your WHM account. If you're unsure how to do this, consult your hosting provider's documentation or support team.
  2. Once you're in WHM, locate the 'Email' section. You can do this by using the search bar at the top left of the screen. Just type 'Email' and select it from the dropdown menu.
  3. Under the 'Email' section, click on the Mail Delivery Reports link.

Using Mail Delivery Reports

Now that we've accessed the Mail Delivery Reports, let's go through how to use them.

The basic search is a quick way to find information on specific emails.

  1. Enter the details of the email you're looking for in the Search field. You can search by recipient, sender, subject line, or even a specific date range.
  2. Click Run Report to generate the search results.

The advanced search gives you more options to narrow down your search. You can select to show/hide the following:

  • Show Deferrals — Emails that the system deferred.
  • Show Deliveries — Emails that the system delivered successfully.
  • Show Failures — Emails that the system has not yet delivered.
  • Show In-Progress — Emails that the mail transport agent received, but the system has not yet processed (for example, succeeded, failed, or deferred).

Interpreting Mail Delivery Reports

Once you've run a report, you'll see a list of emails that match your search criteria. Each entry will show you the sender, recipient, subject line, time sent, and the status of the delivery.

Understanding Delivery Status

The delivery status can be 'Accepted', 'Filtered', 'Unknown', 'Deferred', 'Rejected' or 'Failed'. An 'Accepted' status means the email was delivered successfully. 'Deferred' means the email will be tried again later. 'Unknown' means the email is currently being sent. 'Failed' means the email was not delivered.

By clicking on the Actions button next to each entry, you can see more detailed information about the delivery process of that email.

Email Privacy

Remember, as an administrator, you must respect the privacy of your users' emails. Do not read or disclose the content of these emails without proper authority.


This tutorial covered how to access, use, and interpret Mail Delivery Reports in WHM. With this tool, you can troubleshoot email delivery issues and ensure your server's email system is running smoothly.

External links

Mail Delivery Reports - WHM Documentation