Add an Incoming Whitelist Filtering Rule

You can add rules that apply to a specific domain in the Domain Rules tab or, if accessing from the Admin Level, to all domains linked to the logged in Admin in the Admin Rules tab.

  1. In the Admin Level or Domain Level Control Panel, select Incoming - Protection Settings > Whitelist filtering rules.
  2. The Domain Rules tab is displayed in the Incoming Whitelist filtering rules page.

    If you want to apply a rule to a domain, remain on this tab. If you are accessing from the Admin Level and want to apply a rule to a specific Admin, open the Admin Rules tab.

  3. Click on Add rule:
  4. The dialog that is displayed here depends on whether you have enabled or disabled the 'Use advanced custom filtering rules' option in the User profile page. For more information, see Manage Your Admin User Profile or Manage Your Domain User Profile.

    • If the option is Inactive you will see the 'Add a new simple Whitelist filtering rule' dialog:
    • If this is Active, you will see the 'Add a new advanced Whitelist filtering rule' dialog:
  5. Choose from the following filters:
  6. Field/Option Description
    Simple page
    Domain (only displayed at Admin Level) Select the domain the rule will apply to.
    Rule name Add the name of this rule.
    Match Use the Match fields to structure your rule.
    Advanced page
    Domain (only displayed at Admin Level) Choose the domain you want to apply the rule to from those available in the Domain dropdown. (When you are accessing this page at the Domain Level, the system applies the rule to the logged in domain).
    Rule name Enter the name you want to give this rule in the Rule name field.
    Priority In the Priority field enter a number to represent the priority given to the rule.

    Rules are evaluated by Priority from the lowest number to the highest number, until one matches or all rules have been checked. All Whitelist rules are checked before Blacklist rules.

    Header name If you want to restrict the check to a particular header, enter the Header name. You may enter a regular expression here, if required.
    Regular expression

    Enter the regular expression for the rule in the Regular expression field.

    Tip - Use the Cheatsheet panel on the right of the page for examples of how to build your regex.


    Choose what you want the rule to match. The following options are available:

    • Subject
    • To
    • From
    • CC
    • Country
    • Continent
    • Message Body
    • Recipient
    • Sender
    • Sender IP
    • Sender Hostname
    • URL
    • Language
    • Attachment Type
    • Attachment Name
    • Attachment Type (auto-detect)
    Flags The following flags are available:
    • i (ignore case)
    • m (^ and $ match start and end of line),
    • s (. matches newline)
    • x (allow spaces and comments)

  7. Click Save when finished.

Unfortunately, the Technical Support team is unable to support any customisation of the predefined Rulesets or those you build yourself.

Due to the potential complexity in building a regex pattern, we advise that only users with regex experience should attempt to create new rules or customise existing ones.

Advanced Filtering Rule Examples and Quick Reference