Child pages
  • Track Delivery
This documentation is for cPanel & WHM version 84 CURRENT builds.  The "RELEASE" version of our documentation can be found in the Version 82 Documentation space.


Skip to end of metadata
Go to start of metadata

(cPanel >> Home >> Email >> 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:

  • 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

Important:

  • 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:

ColumnDescription
Event

An icon that indicates the message's delivery status:

IconDescription
The system delivered the message.
The message's status is unknown, or delivery is in progress.
The system deferred the message.
The message encountered a delivery error.
The system archived the message. For more information, read our Archive documentation.
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).
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.
From AddressThe email address on your system that sent the message.
SenderThe sender's cPanel username.
Sent TimeThe date and time when the user sent the message.
Spam ScoreThe message's Apache SpamAssassin™ score.
RecipientThe email address to which the user sent the message.
ResultA message that describes the delivery results.
Actions

Click the information icon () 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).

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:

OptionDescription
Select AllSelect all of the available options.
EventAn icon that indicates the message's delivery status.
UserThe cPanel username of the sender.
DomainThe sender's domain.
From AddressThe email address on your system that sent the message.
SenderThe sender's cPanel email address.
Sent TimeThe date and time at which the user sent the message.
Sender HostThe sender's host's IP address.
Sender IP AddressThe sender's IP address.
AuthenticationA type of SMTP authentication.
Spam ScoreThe email's Apache SpamAssassin score.
RecipientThe email address to which the user sent the message.
Delivery UserThe cPanel username that owns the recipient's email address.
Delivery DomainThe domain of the recipient.
Delivered ToThe email address of the recipient.
RouterThe internal router that handled the delivery of the message.
TransportThe recipient's SMTP method type.
Out TimeThe date and time at the intended recipient received the message.
IDThe outgoing message's ID.
Delivery HostThe hostname of the recipient's email exchanger.
Delivery IP AddressThe recipient email exchanger's IP address.
SizeThe size of the outgoing message, in bytes.
ResultA 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 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.

IconDescription

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 will receive the message.

The system discarded the message.