Last modified: October 30, 2024

---

Looking for this interface?

Note:

Your hosting provider can enable or disable this interface in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).

Overview

This interface displays a report about email message deliveries from your account. You can also use this interface to trace an email’s delivery route and to find delivery problems.

Search

The Recipient Email (optional) text box lets you to filter the Delivery Report table results to a specific email address. To do so, perform the following steps:

1. Enter an email address in the Recipient Email (optional) text box.
2. Click Run Report. The system will filter the Delivery Report table to only display results for the recipient email address. It will also display the Email Address Trace diagram.

To reset the Delivery Report table’s results, perform the following steps:

1. Remove the email address from the Recipient Email (optional) text box.
2. Click Run Report. This will remove the filter from the Delivery Report table and display all email message results.
   Note:

   This will not reset the Email Server Trace diagram.

You can use the following options to filter the results of the Delivery Report table:

Options	Description
Show Blocked & Failed	This option will filter the table to only display delivery failures.
Show All	Display all deliveries. This will also update the Recipient Email (optional) search results.

Delivery Report

By default, the table lists the 250 most recent messages sent to and from your cPanel account’s mailboxes. This includes every delivery success and failure. The table sorts the data into the following columns by default:

Column	Description
Event	An icon that indicates the message’s delivery status.
From Address	The email address on your system that sent the message.
Sender	The sender’s cPanel username.
Sent Time	The date and time when the user sent the message. This report uses your browser’s timezone setting.
Spam Score	The message’s Apache SpamAssassin™ score.
Recipient	The email address to which the user sent the message.
Result	A message that describes the delivery results.
Actions	Click the information icon () to view and print information about the selected message. This includes information such as a message’s sender, recipient, and username.

The system retains this data for the amount of days that your hosting provider specifies for the The interval, in days, to retain Exim stats in the database (Minimum: 1; Maximum: 365,000) option in the Stats and Logs section of WHM’s Tweak Settings interface (WHM » Home » Server Configurations » Tweak Settings).

Event icons and troubleshooting

The icons in the Event column can show potential problems with message delivery. Follow the recommended actions to troubleshoot problems, and contact your hosting provider if you need more help.

Event Icon	Description	Possible reason	Recommended action
	The system delivered the message.	N/A	N/A
	The message’s status is unknown, or delivery is in progress.	The remote server may be slow.	Check the Result column for timeout or connection errors.
	The system deferred the message and will try again to send it.	The remote server may not be accessible.	Check the Result column for timeout errors.
	The message encountered a delivery error.	The domain may not exist.	Check the email address for spelling errors.
	The system archived the message.	You or your hosting provider have enabled archiving.	Read our Archive documentation.
	The system rejected and discarded the message at Simple Mail Transfer Protocol (SMTP) time.	The sender’s server may not use a secure configuration or may be on a blacklist.	Check the Real-time Blackhole List (RBL) for the server’s IP address.
	The mail server accepted the message but it did not deliver the message to the recipient’s inbox.	Spam software may have filtered the message, or the recipient may have custom email filters.	Check the recipient’s spam folder for the message.

Delivery Report table options

You can filter your search results with the following options:

Record selection

To filter the records:

1. Select any of the following checkboxes:
   • Show Successes
   • Show Deferred
   • Show Failures
   • Show In-Progress
2. Select the maximum number of results to display from the Max Results/Type menu.

Column selection

To select the columns that you wish to display or hide in the Delivery Report table, click the table options icon (). A new window will appear. In this window, select or deselect the checkboxes for the following column headers:

Header	Description
Select All	Select all of the available options.
Event	An icon that indicates the message’s delivery status.
User	The cPanel username of the sender.
Domain	The sender’s domain.
From Address	The email address on your system that sent the message.
Sender	The sender’s cPanel email address.
Sent Time	The date and time when the user sent the message. This report uses your browser’s timezone setting.
Sender Host	The sender’s host’s IP address.
Sender IP Address	The sender’s IP address.
Authentication	A type of SMTP authentication.
Spam Score	The email’s Apache SpamAssassin score.
Recipient	The email address to which the user sent the message.
Delivery User	The cPanel username that owns the recipient’s email address.
Delivery Domain	The domain of the recipient.
Delivered To	The email address of the recipient.
Router	The internal router that handled the delivery of the message.
Transport	The recipient’s SMTP method type.
Out Time	The date and time when the intended recipient received the message. This report uses your browser’s timezone setting.
ID	The outgoing message’s ID.
Delivery Host	The hostname of the recipient’s email exchanger.
Delivery IP Address	The recipient email exchanger’s IP address.
Size	The size of the outgoing message, in bytes.
Result	A message that describes the delivery results.
Actions	Displays the information icon (). This lets you view and print information about a message.

Email Address Trace

This diagram displays how the system sent or would send an email message to the given email address. It traces how the local system routes a message.

Each of the following icons in the diagram displays information about the message’s delivery path:

Icon	Description
	The system delivered the message to a local inbox.
	The system delivered the message to a remote mailbox.
	The system deferred the message.
	The system rejected the message.
	The system encountered a delivery error.
	The system received the message.
	The system discarded the message.