Email Filters

This element (ia-generated) isn't supported, or may require an update to be displayed. You can try to refresh the app.

Overview

This interface allows you to create, edit, and remove email filters for a selected email account.
An email filter allows you to set a rule for incoming messages (for example, a message from desired sender). If a message matches that rule, then the system can automatically perform an action on that message (for example, deleting the message).
Important
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:
    .1In the Filters by Users table, click Manage Filters for the appropriate email account.
NoteIf you access this interface from cPanel’s Webmail interface, proceed to step 2.
    .2Click Create a New Filter.
    .3Enter a name for the filter in the Filter Name text box.
    .4Configure your filter’s rules and actions.
NoteFor detailed information on how to configure your filter, read our  How to Configure Email Filters  article.
    .5Click Create.

Current Filters

To list an email account’s filters, click Manage Filters in the row of the appropriate email account. The Current Filters table lists all of the filters for the selected email account in the order the filters run.
New filters are appended to the Current Filters list, meaning they will run after pre-existing filters. You may drag and drop the filters to change the order in which the filters will run.

Edit a filter

To edit an existing filter, perform the following steps:
    .1Click Edit next to the appropriate filter name.
    .2Make the desired changes to the filter.
    .3Click Save.

Delete a filter

To delete a filter, perform the following steps:
    .1Click Delete for the appropriate filter name.
    .2Click Delete Filter.

Test a filter

To test a filter, perform the following steps:
    .1In the Filters by Users table, click Manage Filters next to the desired email account.
    .2Enter a test email message in the Filter Test text box.
NoteInclude the characters, words, and conditions that you configured for your filter.
    .3Click Test Filter. The Filter Trace Results interface will appear.

The Filter Trace Results interface

The Filter Trace Results interface will display results similar to the following:
Sub-condition is false: not first_delivery
Condition is false: not first_delivery and error_message
Condition is false: $message_body contains Keyword
Return-path copied from sender
Sender      = username@hostname.example.com
Recipient   = username@hostname.example.com
Testing Exim filter file "/home/example/etc/example.com/filtertest/filter"
Headers charset "UTF-8"
Filtering did not set up a significant delivery.
Normal delivery will occur.
The results contain the following information:
  • Each condition in the filter, and whether it returned a true or false result.
  • The Sender and the Recipient of the test message.
  • The filter file’s name.
  • The character set of the message.
  • Whether the filter triggers a change in delivery or if it will deliver normally.
  • Filtering did not set up a significant delivery. Normal delivery will occur. — The system will deliver the message to the mailbox.
  • Filtering set up at least one significant delivery or other action. No other deliveries will occur. — The system will deliver the message to another mailbox or folder, or it will not deliver the message.