White / Black - lists -- whitelists for Newsletter module

MailCleaner Support
Added about 2 years ago

In this document we will speak about whitelists, every thing is exactly the same for the blacklist feature, the warn feature and the dedicated whitelists for newsletters feature

Please note that whitelist are applied before blacklists so you can blacklist a whole domain at domain level filtering while a end user will still be able to whitelist a specific email address from that domain.

White / black -lists feature

There is no global whitelist in MailCleaner. The feature called Whitelist will only prevent the filters in


to stop a message.

To enable whitelists, you need to check

Configuration->AntiSpam->Enable access to whitelists

Once this is done and applied, you can add whitelist at 3 different levels :

  • Server level : these whitelists will be applied to all users belonging to every domain that activated whitelists. Those whitelists are in


To activate whitelists for a domain, you need to check

Configuration->Domains-> domain name ->Filtering-> Enable whitelists

  • Domain level ; these whitelists will be applied to the users of this domain :

    Configuration->Domains-> domain name ->Filtering

  • User level : these whitelists will only be applied for this domain. These can be found in the private web interface of the user.

Newsletters whitelists

The anti newsletters module is enabled by default but is only applied to users/domains who disabled :

Configuration->Domains-> domain name -> Allow newsletters by default

Entry syntax

(for the following we will consider blacklists, to we ll speak about blocking elements but in case of whitelists or whitelists dedicated to newsletters, it is the same)

In order to block a precise email address, let s say user@domain.tld, please use


In order to block all the email addresses from the domain : domain.tld, please use :


If you dont use the @ sign with this rule for example :


You will also block users from the domain @another-domain.tld
For this last example, you would also block domain.tld@realdomain.tld

Not using the @ sign is generally on way to white/blacklist several servers or sub domains. In that case, you should use :


as the $ sign means "end of string" so this last example would mean any address that ends up with domain.tld

To insert black/white lists in bulk