Technical guide on using the cPanel Track Delivery tool to troubleshoot mail bounce-backs, delivery delays, and routing errors in real-time.
Track Delivery: Troubleshooting Email Failures in cPanel
When an email fails to reach its destination, the Track Delivery tool (based on the server's Exim mail logs) provides the exact SMTP error code and reason for the failure. This tool is the definitive source for diagnosing whether a message was blocked by a remote server, filtered by spam settings, or failed due to routing misconfigurations.
1. Accessing and Filtering Reports
- Log in to cpanel.hovixa.com.
- Navigate to the Email section and click Track Delivery.
- By default, the table shows the last 250 delivery attempts.
- Recipient Email: Enter a specific address and click Run Report to isolate logs for a single user.
- Show Blocked & Failed: Check this box to hide successful deliveries and focus strictly on errors.
2. Interpreting Delivery Status Icons
The Event column uses icons to indicate the outcome of the delivery attempt:
- Green Check (Success): The message was accepted by the recipient's mail server.
- Yellow Warning (Deferred): The message is in a retry loop. This usually indicates a temporary issue on the receiving end (e.g., rate limiting or "Greylisting").
- Red X (Failure): The message was rejected. It will not be delivered.
- Black Warning (Filtered): The message was accepted but redirected or deleted by a system filter or SpamAssassin.
3. Common SMTP Error Codes and Resolutions
Click the (i) Information icon in the "Actions" column to see the full server response. Use the table below to decode the results.
| Error Code | Interpretation | Technical Resolution |
|---|---|---|
| 550 No such user | The recipient address does not exist on the destination server. | Verify the spelling of the recipient's email. |
| 550 SPF Check Failed | The recipient server rejected the mail because your SPF record is missing or incorrect. | Use the Email Deliverability tool to repair your SPF record. |
| 451 / 421 Temporary Error | The remote server is busy or Greylisting is active. | No action required; the Hovixa server will automatically retry for up to 4 days. |
| 554 IP Blacklisted | The Hovixa server IP is flagged by an RBL (Real-time Blackhole List). | Contact Hovixa Support to request an IP reputation check or delisting. |
4. Advanced: Checking the "System" Result
The System column provides internal routing information. If you see virtual_user, the mail was handled locally. If you see dkim_remote_smtp, the mail was signed and successfully sent to an external server. If the system shows local_delivery but the mail was meant for an external provider (like Gmail), your Email Routing is incorrectly set to "Local" instead of "Remote."
Summary of Best Practices
- Check the Log First: Always check Track Delivery before opening a support ticket. 90% of failures provide the reason in the "Information" dialog.
- Bounce-back Messages: If you receive a "Non-Delivery Report" (NDR) in your inbox, the text inside the attachment matches the data shown in this tool.
