Skip to main content

How to Trace an Email Delivery in WHM

You can track the path and status of an email as it moves through the mail server using the Exim Mail Queue. This process allows a Server Administrator to determine if an email is stuck in a queue, held by a filter, or successfully delivered to the...

You can track the path and status of an email as it moves through the mail server using the Exim Mail Queue. This process allows a Server Administrator to determine if an email is stuck in a queue, held by a filter, or successfully delivered to the destination.

Before you begin

You will need:

  • Server Administrator access to WHM

  • The specific Message ID or the sender/recipient email addresses involved in the delivery

Trace an Email Delivery

  1. Log in to WHM.

  2. Navigate to Email > Mail Delivery Reports.

  3. Enter the sender or recipient email address in the search field.

  4. Select Search.

  5. Review the results to see the delivery status and the specific hop where a message may have failed.

To investigate a message currently held in the local mail queue:

  1. Log in to WHM.

  2. Navigate to Email > Mail Queue.

  3. Locate the message in the list. You can search by the sender, recipient, or a unique identifier.

  4. Select the message and click Trace.

  5. Review the trace output to identify the specific server or rule causing a delay or failure.

Confirm the result

  • The system will display a detailed log of the hops the email took.

  • If the email is in the queue, the trace will show the specific reason (such as a DNS failure or a rejected relay) preventing it from leaving the server.

  • If the email was successfully delivered, the trace will end with a "Delivered" or "Accepted" status from the remote server.

If the email remains in the queue

If the trace indicates a "Deferred" status, the message is likely waiting for a retry due to a temporary issue with the receiving server. If the trace shows a "Rejected" status, the email was blocked by a security filter or a configuration error.

Limitations

This tool provides information regarding the server's interaction with the email. It cannot provide information on actions taken by the recipient's email provider after the message has successfully left the Hostek server.

Did this answer your question?