SpamTitan

Pattern Settings

Field

Description

Filter Expression:

This is how the pattern filter will be evaluated. All expressions are case-insensitive.

Starts with

The body or header must start with this value.

Ends with

The body or header must end with this value.

Contains

The body or header must contain this value.

Equals

The body or header must be exactly equal to this value.

Matches any word in

Enter a list of words separated by a comma. If any word on the list is in the body or header, the pattern filter will trigger.

Matches regular expression

Enter a regular expression to match against the body or header. See https://www.regular-expressions.info for information on using regular expression.

Matches multiple rules

Select this option to match multiple rules you have already created using the Test Mode rule type. See Creating a Meta Rule Pattern Filter.

Apply to Body:

Check for this test to trigger on the body of an email.

Use Rawbody

Check this to allow your body rules to trigger on the HTML of an email. 

"The rawbody directive defines a test to be applied to the text of a message, as it would be likely to appear to a person reading the message in an HTML-based mail client. The Subject header is not included. All textual MIME components of the message are decoded, and the message is split into lines based on the line breaks in the message. The test is then applied to each message line."

Excerpt from SpamAssassin, by Alan Schwartz (2004)

Warning

Rawbody tests can cause excessive CPU usage and cause mail queues, so use with caution.

Apply to Headers:

Check this to enter a header (one per line) for the pattern filter to trigger on. Leave empty to trigger on any header. 

Enter one header per line. Syntax is either From or From:.

Any email header can be entered here, e.g. To, From, Cc, Subject, ALL, X-Header-From-Another-Box, Received. See this wiki for a list of common headers.

Special header rules are as follows:

EnvelopeFrom

Triggers on the Envelope MAIL FROM instead of the From header.

ToCc

Triggers on both the To and Cc headers.

ALL

The rule will trigger on any header.

There are also three options available to append to a header:

:raw

Append to the end of a header to prevent decoding of quoted-printable or base64 encoded headers.

:addr

Append to the end of a From or To header to make the rule only trigger on the address in the header.

:name

Append to the end of a From or To header to make the rule only trigger on the name in the header.

Rule Type:

Determines how the test should be scored/treated.

Test Mode

Test Mode does not affect the score of the mail, it is used to create meta pattern filters with "Matches multiple rules".

Hard Blacklist

Adds a score of 100 to the email, causing it to be blacklisted.

Hard Whitelist

Subtracts a score of 100 from an email, causing it to be whitelisted.

Soft Blacklist

Adds a configurable positive score, between 0.01 and 99.99 (default: 5).

Soft Whitelist

Subtracts a configurable negative score, between -0.01 and -99.99 (default: 5).

Comment:

Add additional notes for the rule.

Disable Rule:

Check to prevent a rule from triggering without deleting the rule.