How to Create Mail Filter Rules For Mailing Lists
Overview
This document explains how to create mail filter rules in cPanel’s Mailing Lists interface (cPanel >> Home >> Email >> Mailing Lists). Mail filters allow you to control which email messages your server delivers.
Create a mail filter rule
- Mailman’s Spam Filters feature requires that you enable spam filters. To enable Apache SpamAssassin™ for your cPanel account, select Enable Apache SpamAssassin in cPanel’s Spam Filters interface (cPanel >> Home >> Email >> Spam Filters).
- Generally, the recipient does not receive the
BCC
field in an email’s header. For this reason, you cannot use theBCC
field in a filter.
To control which email messages your server delivers to your mailing lists, use Mailman’s Spam filters interface. To create a mail filter rule with the Header filters section of the Spam filters interface, perform the following steps:
-
Access Mailman’s Spam filters interface. To do this, perform the follow steps:
- Navigate to cPanel’s Mailing Lists interface (cPanel >> Home >> Email >> Mailing Lists).
- Click Manage for the mailing list that you wish to edit. A new interface will appear.
- In the Configuration Categories section at the top, click Privacy options.
- Click Spam filters.
-
In the Spam Filter Rule 1 text box, enter a regular expression (regex) that matches the messages to which to apply an action. For example:
X-Spam-Status:s+Yes
Notes:- This example applies to any message that SpamAssassin scores as spam.
- The number of plus sign characters (
+
) indicates the Apache SpamAssassin spam score. - Apache SpamAssassin adds information to the header of each mail message that it reviews. You can use this information to determine which mail filter rules to use.
-
Next to Action:, select the action for Mailman to perform on the messages that match the filter. You can select the following settings:
- Defer — Disable the filter rule.
- Hold — Hold the messages that match the filter rule until a moderator approves it.
- Reject — Reject the messages that match the filter rule.
- Discard — Delete the messages that match the filter rule.
- Accept — Accept the messages that match the filter rule.
-
Click Submit Your Changes.
Legacy anti-spam filters
A moderator of the mailing list must approve the messages that match any spam filters in the Legacy anti-spam filters section of the Spam filters interface.
To create a mail filter rule with the Legacy anti-spam filters section of Apache SpamAssassin’s Spam filters interface, perform the following steps:
- In the Legacy anti-spam filters text box, enter the header information to filter.
- Click Submit Your Changes.