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

Overview

This document explains how to create mail filter rules in cPanel's Mailing Lists interface (Home >> Mail >> Mailing Lists). Mail filters allow you to control which email messages that your server delivers.

To control which email messages that your server delivers to your mailing lists, use Mailman's Spam filters interface. To access Mailman's Spam filters interface, click the Manage link that corresponds to the mailing list that you wish to edit.

Important:

Mailman's Spam Filters feature requires that you enable Apache SpamAssassin™. To enable Apache SpamAssassin for your cPanel account, select Enable Apache SpamAssassin in cPanel's Apache SpamAssassin interface (Home >> Mail >> Apache SpamAssassin).

To access Mailman's Spam filters interface, click Manage for the mailing list that you wish to configure.

Note:

Generally, the recipient does not receive the BCC field in an email's header. For this reason, you cannot use the BCC field in a filter.

How to create a mail filter rule

To create a mail filter rule with the Header filters section of the Spam filters interface, perform the following steps:

  1. 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 rule 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.
  2. Next to Action:, select the action for Mailman to perform on the messages that match the filter. The following table describes the available options:

    OptionExplanation
    DeferThis option disables the filter rule.
    HoldThis option directs Mailman to hold the messages that match the filter rule until a moderator approves it.
    RejectThis option directs Mailman to reject the messages that match the filter rule.
    DiscardThis option directs Mailman to delete the messages that match the filter rule.
    AcceptThis option directs Mailman to accept the messages that match the filter rule.
  3. Click Submit Your Changes.

Legacy anti-spam filters

To create a mail filter rule with the Legacy anti-spam filters section of the Spam filters interface, perform the following steps:

  1. In the Legacy anti-spam filters text box, enter the header information to filter.
  2. Click Submit Your Changes.

Note:

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.

Additional documentation