Email Filters

This interface allows you to filter your .edu email account.


We strongly recommend that you use multiple, simple filters instead of a single large filter. Exim, the server's mail transfer agent, handles many small rules more efficiently than a single large rule.

Create a filter

To create a new filter, perform the following steps:

  1. In the Filters by Users table, click the manage_filters link next to the appropriate email account.
  2. Click Create a New Filter.

  3. Enter a name for the filter in the Filter Name text box.
  4. Configure your filter's rules and actions.


    For detailed information on how to configure your filter, read our How to Configure Mail Filters article.

    Click Create.

Current Filters

To list an email account's filters, click the manage_filters link in the row of the appropriate email account. The Current Filters table lists all of the filters for the selected email account.

Edit a filter

To edit an existing filter, perform the following steps:

  1. Click edit next to the appropriate filter name.

  2. Make the desired changes to the filter.
  3. Click Save.

Delete a filter

To delete a filter, perform the following steps:

  1. Click deletenext to the appropriate filter name.
  2. Click Delete Filter to confirm.

Test a filter

To test a filter, perform the following steps:

  1. In the Filters by Users table, click manage_filters next to the desired email account.

  2. Enter a test email message in the Filter Test text box.


    Include the characters or words you set up for your filter. 

  3. Click Test Filter

How to Configure Mail Filters

Email filters use the criteria that you specify to determine how to handle email messages. The following cPanel interfaces allow you to configure email filters:

    The Global Filters interface (Home >> Email >> Global Filters) — Global filters affect the cPanel account's email addresses.
    The Email Filters interface (Home >> Email >> Email Filters) — User level filters affect specific email addresses on the cPanel account.

Filter rules and criteria

The first set of options specifies which part of the email message the system examines to determine whether the message matches your filter parameters.

You can choose from the following options:


After you select the portion of the email message that the system will examine, select the type of comparison between that portion of the email and the criteria that you enter.

You can choose from the following options:

Spam Score

The following options are only applicable when you select the Spam Score option:


When you create a filter that uses several operators, the system processes the and operator before the or operator. For example:

  • The system processes A or B and C as A or (B and C).
  • The system processes A and B or C as (A and B) or C.


Enter the criteria to use in the text box under the Rules menus. The type of data that you enter determines the comparison that the system performs.

For example, if you select the From and Equals filters, enter as the criteria. The system determines that any email from matches the filter, but does not match because it contains additional letters.


Exim converts newlines into spaces in the $message_body field. Do not add \n characters to any body filters that you create.


When cPanel determines that an email message matches your filter, it handles that message with the any of the following actions that you specify: