Knowledgebase

This interface allows you to search for emails that users on your system sent and received.

Important:

Search for emails

Use the Report Inquiry section of the interface to define your search parameters.

To search for emails, perform the following steps:

Enter the text for which you wish to search in the Search... text box.

Note:

Search terms are optional.
Select the part of the email that you wish to query. The default trait is Recipient.
Select a Search Type button.

Important

Partial searches may require more time to complete than other search types.
Select a Delivery Type button.
Enter a date range in the Start Date and End Date text boxes, or click the calendar icons to select dates.
Important
- Enter dates in the MM/DD/YYYY format, where MM is the two-digit month, DD is the two-digit day, and YYYY is the four-digit year.
- A large date range drastically increases query time for busy mail servers.
Enter a time range in the Start Time and End Time text boxes. Select AM or PM next to each text box.
Click Run Report.

By default, results for your query appear in the following columns:

Column	Description
Event	This column contains an icon that indicates the email's delivery status: — The system delivered the email successfully. — The email's status is unknown, or delivery is in progress. — The email was deferred. — The email encountered a delivery error. — The email was rejected at SMTP time. This typically occurs because the sender's server is configured insecurely or is listed on a RBL.
Sender	The email address that sent the email.
Sent Time	The date and time at which the email was sent.
Spam Score	A score that the system bases on the number of spam-related traits that the email contains.
Recipient	The email address to which the email was sent.
ID	The unique identifier for the outgoing email.
Result	This column contains a short email about the delivery.
Actions	Click the magnifying glass icon () to view and print information about the selected email. This information includes the email's sender, recipient, and username.

You can further refine your results in the results table's Search... text box.

Note:

The results remain filtered until you clear the search box.

The results table also features an Advanced Search option. Click Advanced Search to access the four available checkboxes:

Checkbox	Description
Show Deliveries	Select this checkbox to view the emails that the system delivered successfully.
Show Deferrals	Select this checkbox to view the emails that were deferred.
Show Failures	Select this checkbox to view the emails that were not delivered.
Show In-Progress	Select this checkbox to view the emails that were received by the mail transport agent but that the system has not yet processed (for example, succeeded, failed, or deferred).

You may deselect checkboxes to remove the email types from the results table.

Note:

cPanel & WHM limits results to 5000 per Advanced Search type filter.

You may add columns to the results table to view more information. To add columns, perform the following steps:

Click the gear icon () in the top right corner of the results table, and select the checkbox for the information that you wish to view in the table. To hide information from the table, deselect the checkbox.
To automatically select the default columns, click Reset to Default.

You can choose the following additional columns:

Column	Description
User	The sender's cPanel username.
Domain	The sender's domain.
Sender Host	The sender's hostname.
Sender IP	The sender's IP address.
Authentication	The sender's authentication type.
Delivered To	The recipient's email address.
Delivery User	The username that owns the recipient's email address.
Delivery Domain	The recipient's domain.
Router	The internal router that the mail server uses to determine the email's destination.
Transport	The recipient's SMTP type.
Out Time	The date and time at which the intended recipient received the email.
Delivery Host	The recipient mail exchanger's hostname.
Delivery IP	The recipient mail exchanger's IP address.
Size	The size of the outgoing email, in bytes.