A Domain Content Filter is designed to automatically process incoming or outgoing messages based on specific criteria, such as moving them to a folder or rejecting them based on attachment types. If a filter is not running as expected, it typically indicates a configuration mismatch, a syntax error in the filter rules, or a conflict with other system settings.
Before you begin
You will need:
Domain Administrator access to the SmarterMail administrative interface.
The specific name of the Domain Content Filter that is not functioning.
The criteria and actions currently assigned to that filter.
Check the filter configuration and logic
Log in to the SmarterMail administration panel.
Navigate to Domains > Domain Management.
Select the domain and click Edit.
Navigate to the Content Filters section.
Locate the specific filter and click Edit.
Verify that the Action (e.g., Move to Folder, Reject, etc.) is correctly assigned.
Verify that the Criteria (e.g., Sender, Subject, Keywords) are accurately defined.
Ensure there are no extra spaces or special characters in the criteria fields that could interfere with matching.
Save the changes and test the filter with a test email.
Check for conflicting filters
If multiple filters apply to the same message, the order of the list determines which filter is processed first.
In the Content Filters section of the domain settings, view the list of all active filters.
Identify if a filter higher in the list matches the same criteria as the non-functioning filter.
If a higher filter matches the message first, it will execute its action and stop the processing of subsequent filters.
Adjust the order of the filters if necessary to ensure the intended filter is evaluated.
Check for specific exclusion rules
Some filters are designed to only run under specific conditions, such as only for internal senders or only for specific protocols.
Review the filter's specific settings to see if it is restricted to a specific Sender Type or Source.
If the filter is restricted to "Internal" and the test email is sent from an external address, the filter will not trigger.
Ensure the filter's scope matches the intended use case.
Check for "Reject" actions on higher filters
If a filter higher in the list is set to "Reject" a message, the message will be dropped before it reaches the lower filters.
Review the filters listed above the one that is not running.
Check if any of those filters have a Reject action for the same criteria.
If a message is being rejected by a higher filter, it will never reach the lower filter.
How to Gather Information for Support
If the filter continues to fail after verifying the configuration and order, gather the following information before contacting Hostek support:
The name of the domain.
The name of the specific Domain Content Filter.
The exact criteria used in the filter.
The specific action the filter is intended to perform.
A sample email (or the Message ID) that failed to trigger the filter.
The results of a "Test" email sent to the account.
Limitations
Content filters do not process messages that are rejected by the SmarterMail Gateway or other system-level security filters before they reach the mail processing engine.
If a message is moved to a folder by a higher-priority filter, it will not be processed by subsequent filters.
