Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

(Home >> Mail >> Forwarders)


You can use this interface to forward copies of one address's incoming emails to another address. This allows you to use one account to check mail for several email addresses. You can also discard email or send (pipe) mail to a program.

To view forwarders for a specific domain on your account, select the domain for which you wish to set forwarders from the Managing menu.


Use the Box Trapper Forward List feature for email accounts that use BoxTrapper. For more information, read our BoxTrapper documentation.

Email Account Forwarders

The Email Account Forwarders table lists all of the email accounts for which you have configured forwarding.

  • To quickly find a specific email address, enter a keyword in the Search text box and click Go.
  • To view the route that a forwarded message takes, select Trace in the Functions column for that email address.
  • To delete a forwarder, click Delete in the appropriate row. Click Delete Forwarder to confirm that you wish to delete that forwarder.

Add Forwarder

To add a mail forwarder, perform the following steps:

  1. Click Add Forwarder.
  2. In the Address to Forward text box, enter the address for which you wish to forward email.
  3. Select one of the following options:
    • Forward to email address — Select this option to forward mail to another address. Enter the address to which you wish to forward mail in the text box.
    • Discard and send an error to the sender (at SMTP time) — Select this option to discard incoming messages and automatically send a failure notice to the senderEnter the desired failure message in the Failure Message text box.
    • Click Advanced Options to view the following additional options:
      • Forward to a system account — Select this option to forward mail to a system user. Enter the appropriate username in the text box.


        • This text box accepts the username of any user on the server.
        • System accounts do not have a public-facing email address.
      • Pipe to a program — To automatically forward messages to a program, define a path to the program (for example, /home/$utility) in the text box. For more information, read the Pipe to a Program section below.

      • Discard (Not Recommended) — Select this option to discard incoming messages without a failure notice.


        We do not recommend this option, because the sender will not know that the delivery failed.
  4. Click Add Forwarder.



  • If you do not delete the cPanel account for which mail is forwarded, both accounts will receive mail.
  • If you wish to forward mail to another account but not receive mail at your cPanel account, create a forwarder from an address that does not have a cPanel account. 
    • If the account already exists, delete it in cPanel. 
    • The system will forward all of the mail that you receive to the destination that you configure in this interface.


Pipe to a Program


Make certain that your script uses the proper file permissions (0700). To change your script's file permissions, run the chmod 0700 myscript.php command, where myscript.php represents your script's location and file name.

Use the Pipe to a Program option to parse and enter email information into a different system. For example, use the Pipe to a Program option to pipe email information to a program that enters email information into a ticket system.

  • STDIN pipes email and headers to the program.
  • Pipes can accept variables from the $_SERVER array and variables on the command line.

  • The language or environment that you use may cause memory limit issues.
  • If your script produces any output, even a blank line, the system will create a bounce message that contains that output.

When you use the Pipe to a Program option, enter a path that is relative to your home directory. For example, to use the /home/user/ script, enter in the Pipe to a Program text box, where user represents your username.


If you use PHP, make certain that you appropriately wrap your code in start and end tags.


Domain forwarders

You can use domain forwarders to forward copies of all of the incoming mail for all of a domain's addresses to another domain. Domain forwarders override the default address for the forwarded domain.


Domain forwarders only forward mail when a delivery is not successful. For example, if a user sends an email to, the following actions might take place:

  • If is an existing email address or autoresponder, cPanel will not forward the email.
  • If is not an existing email address or autoresponder, cPanel will forward the email.

Delete a domain forwarder

To remove a domain forwarder, click the button in the Delete column that corresponds to the domain forwarder that you wish to remove.

Add Domain Forwarder

To add a domain forwarder, perform the following steps:

  1. Click Add Domain Forwarder.
  2. Enter the domain to which you would like to forward email.
  3. Click Add Domain Forwarder.