Track Delivery

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. Tracing the route can help you find delivery problems.

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

Note:
  • If the server uses a third-party mail service, such as MailScanner, this feature will return invalid results. Also, if your hosting provider has not enabled this feature, the interface will display an empty table. If you experience issues when you use this feature, contact your hosting provider for more information about your server’s configuration.
  • If you do not see messages displayed in this table, your hosting provider has not enabled this feature. Contact them and ask them to enable it in WHM’s Service Manager interface (WHM » Home » Service Configuration » Service Manager).
  • The table only displays messages for which the eximstats database stores data.

By default, the table lists the 250 most recent messages 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 (Info) to view and print information about the selected message. This information 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).

Icon descriptions
Event Icon Description
Success The system delivered the message.
Unknown The message’s status is unknown, or delivery is in progress.
Deferred The system deferred the message.
Error The message encountered a delivery error.
Archived The system archived the message. For more information, read our Archive documentation.
Rejected The system rejected and discarded the message at Simple Mail Transfer Protocol (SMTP) time. This can occur when the sender’s server does not use a secure configuration or the server is on a Real-time Blackhole List (RBL).
Filtered The mail server accepted the message but it did not deliver the message to the recipient’s inbox. This can occur when spam software filters a message or if a recipient has custom email filters.

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 (Options). 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 (Info). This lets you view and print information about a message.

Email Address Trace

This diagram displays how the system would send an email message to the given email address. It traces how the local system routes a message. You can use this feature to find potential problems with message delivery. Each icon displays information about the message’s delivery path:

Note:

The following icons may vary from those that your system uses.

Icon Description
Local The system delivered the message to a local inbox.
Remote The system delivered the message to a remote mailbox.
Defer The system deferred the message.
Reject The system rejected the message.
Error The system encountered a delivery error.
Command The system will receive the message.
Discard The system discarded the message.
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

How do I send e-mail in WordPress through SMTP?

When you use the PHP mail function, you are sending email directly from your web server. This...

Address Importer

Overview This interface allows you to use two types of files to create multiple email addresses...

Archive

Overview Warning: The Archive interface does not appear in your cPanel interface unless...

Autoresponders

Overview This feature allows you to configure automatic email response messages. This is useful,...

BoxTrapper

Overview The BoxTrapper feature filters spam from your inbox through challenge-response...