hmLoadTopic({
hmKeywords:"Account Editor,Account Editor Filters,Copying an IMAP filter rule to all of a domain\'s accounts,Filters,Forwarding messages automatically,IMAP,IMAP Filters,IMAP Mail Rules,Mail,Mail Filters,Mail Rules,Message Filters,Publishing IMAP filters to all of a domain\'s accounts,Redirecting messages automatically,Rules",
hmTitle:"IMAP Filters",
hmDescription:"IMAP and Webmail users can have their mail routed automatically to specific folders on the server by using filters. Similar to the Content Filters, MDaemon will examine the...",
hmPrevLink:"ae_attachments.html",
hmNextLink:"ae_multipop.html",
hmParentLink:"account_manager.html",
hmBreadCrumbs:"Accounts Menu &gt; <a href=\"account_manager.html\">Account Manager<\/a> &gt; Account Editor",
hmTitlePath:"Accounts Menu > Account Manager > Account Editor > IMAP Filters",
hmHeader:"<h1 class=\"p_Heading1\" style=\"page-break-after: avoid;\"><span class=\"f_Heading1\">IMAP Filters<\/span><\/h1>\n\r",
hmBody:"<p class=\"p_BodyText_Center\"><img style=\"margin:0 auto 0 auto;width:41.3125rem;height:28.8750rem;border:none\" src=\".\/images\/account-editor_imap-filters.png\"\/><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">IMAP and <a href=\"wc--overview.html\" class=\"topiclink\">Webmail<\/a> users can have their mail routed automatically to specific folders on the server by using filters. Similar to the <a href=\"cf_content_filter_editor.html\" class=\"topiclink\">Content Filters<\/a>, MDaemon will examine the headers of each of the account\'s incoming messages and then compare them to the account\'s filters. When a message for the account matches one of its filters, MDaemon will move it to the folder specified in that filter, delete the message, or redirect or forward it to the email address of your choosing. This method is much more efficient (for both the client and server) than attempting to filter the messages at the client, and since some mail clients do not even support local message rules or filtering, IMAP Filters provide this option to them.<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">Administrators can create filters via the IMAP Filters screen of the Account Editor, or by using <a href=\"webadmin_web-config.html\" class=\"topiclink\">Remote Administration<\/a>. However, you can also grant your users permission to create and manage filters for themselves within Webmail or Remote Administration. These permissions are set on the <a href=\"ae_worldclient_webadmin.html\" class=\"topiclink\">Web Services<\/a> screen.<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading\" style=\"page-break-after: avoid;\"><span class=\"f_DialogSectionHeading\">Existing IMAP Filtering Rules<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">This box displays the list of all filter rules that have been created for the user\'s account. Filters are processed in the order in which they are listed until a match is found. Therefore, as soon as a message matches one of the filters it will be moved to the folder specified in that filter and then filter processing for that message will cease. Use the <\/span><span class=\"f_ControlIndent\" style=\"font-style: italic;\">Up<\/span><span class=\"f_ControlIndent\"> and <\/span><span class=\"f_ControlIndent\" style=\"font-style: italic;\">Down<\/span><span class=\"f_ControlIndent\"> buttons to move filters to different positions in the list.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Remove<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click a filter in the list and then click <\/span><span style=\"font-family: Arial,Helvetica,sans-serif; font-style: italic; color: #010100;\">Remove<\/span><span class=\"f_ControlIndent\"> to delete it from the list.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Clear all<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click this button to delete all of the user<\/span><span style=\"font-family: \'Times New Roman\',Times,Georgia,serif; color: #010100;\">\'<\/span><span class=\"f_ControlIndent\">s filters.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Up<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click a filter in the list and then click this button to move it to a higher position in the list.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Down<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">Click a filter in the list and then click this button to move it to a lower position in the list.<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading\" style=\"page-break-after: avoid;\"><span class=\"f_DialogSectionHeading\">New IMAP Filtering Rule<\/span><\/p>\n\r<p class=\"p_BodyText\"><span class=\"f_BodyText\">Use the links in this area to construct a new filter rule. When your rule is complete, click <\/span><span class=\"f_BodyText\" style=\"font-weight: bold;\">Add filter<\/span><span class=\"f_BodyText\"> to add it to the <\/span><span class=\"f_BodyText\" style=\"font-style: italic;\">Existing IMAP Filtering Rules<\/span><span class=\"f_BodyText\">.<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_DialogSectionHeading2\">Filter Conditions<\/span><\/p>\n\r<p class=\"p_BodyText2\"><span class=\"f_BodyText2\">Click the links in the first section of the filtering rule to set the filter\'s conditions. When a message matches the filter\'s conditions then the Filter Action will be performed.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">HEADER<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Click &quot;<\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">HEADER&quot;<\/span><span class=\"f_ControlIndent2\"> to choose the header <\/span><span class=\"f_ControlIndent2\">or other message component that you wish to examine as part of the filter rule. You can choose: <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">TO<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">CC<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">FROM<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">SUBJECT<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">SENDER<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">LIST-ID<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">X-MDMAILING-LIST<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">X-MDRCPT-TO<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">X-MDDNSBL-RESULT<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">X-SPAM-FLAG<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">MESSAGE SIZE<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">MESSAGE BODY<\/span><span class=\"f_ControlIndent2\">, or <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">Other...<\/span><span class=\"f_ControlIndent2\"> If you choose &quot;Other...&quot; then a Filter Condition box will open for you to specify a header name not listed. If you click MESSAGE SIZE, the &quot;contains&quot; and \'THIS TEXT\' links will be replaced by &quot;is greater than&quot; and &quot;0 KB&quot; respectively.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">contains \/ is greater than<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent\">Click &quot;<\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">contains<\/span><span class=\"f_ControlIndent\">&quot; or <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">is greater than<\/span><span class=\"f_ControlIndent\"> to choose what type of condition to set when the header is examined. For example, does the header exist or not exist, contain or not contain certain text, start or end with certain text, or the like. You can choose from the following conditions: <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">starts with<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">ends with<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">is equal to<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">is not equal to<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">contains<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">does not contain<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">exists<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">does not exist<\/span><span class=\"f_ControlIndent\">, <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">is greater than<\/span><span class=\"f_ControlIndent\">, or <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">is less than<\/span><span class=\"f_ControlIndent\">. The &quot;is greater than&quot; and &quot;is less than&quot; options are only available when the HEADER link is set to &quot;MESSAGE SIZE.&quot; &nbsp; &nbsp; &nbsp; &nbsp;<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">THIS TEXT \/ 0 KB<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Enter the text that you want MDaemon to search for when scanning the header that you selected for the filter. When the HEADER option is set to MESSAGE SIZE, the link will say &quot;0 KB&quot; and the Filter Condition dialog will have a box for stating the &quot;Message size in KB.&quot;<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">[+] [x] and<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Click <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">[+]<\/span><span class=\"f_ControlIndent2\"> if you wish to set two or more conditions for the filter rule. This will add another line containing the &quot;HEADER,&quot; &quot;contains,&quot; and &quot;THIS TEXT&quot; components for expanding the filter. When testing a message against a filter rule with multiple conditions, by default the message must pass each of the conditions for it to match the rule. Click &quot;<\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">and<\/span><span class=\"f_ControlIndent2\">&quot; and then select &quot;<\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">or<\/span><span class=\"f_ControlIndent2\">&quot; if you want the message to match the rule when it passes any of the conditions. When a filter rule has multiple lines, you can click <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">[x]<\/span><span class=\"f_ControlIndent2\"> next to any line that you wish to delete.<\/span><\/p>\n\r<p class=\"p_DialogSectionHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_DialogSectionHeading2\">Filter Actions<\/span><\/p>\n\r<p class=\"p_BodyText2\"><span class=\"f_BodyText2\">Click the links in the bottom section of the filtering rule to designate the action to take when a message matches the filter\'s conditions.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">move message to<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">Click &quot;<\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">move message to<\/span><span class=\"f_ControlIndent2\">&quot; to designate the filter action. You can choose: <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">move message to<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">delete message<\/span><span class=\"f_ControlIndent2\">, <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">redirect message to<\/span><span class=\"f_ControlIndent2\">, or <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">forward message to<\/span><span class=\"f_ControlIndent2\">.<\/span><\/p>\n\r<p class=\"p_ControlHeading2\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading2\">THIS FOLDER \/ EMAIL<\/span><\/p>\n\r<p class=\"p_ControlIndent2\"><span class=\"f_ControlIndent2\">If you selected the <\/span><span class=\"f_ControlIndent2\">&quot;move message to&quot; action, then click <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">THIS FOLDER<\/span><span class=\"f_ControlIndent2\"> <\/span><span class=\"f_ControlIndent2\">to designate the folder to which the message should be moved. If you chose to redirect or forward the message, then click <\/span><span class=\"f_ControlIndent2\" style=\"font-weight: bold;\">EMAIL<\/span><span class=\"f_ControlIndent2\"> and enter the recipient\'s email address. For redirected messages, no changes to the message headers or body are made. The only thing changed is the SMTP envelope recipient. For forwarded messages, a new message will be created and sent, with the Subject header and body content taken from the original message.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Add filter<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">When you are finished creating your new filter, click this button to add it to the <\/span><span class=\"f_ControlIndent\" style=\"font-style: italic;\">Existing IMAP Filtering Rules<\/span><span class=\"f_ControlIndent\">.<\/span><\/p>\n\r<p class=\"p_ControlHeading\" style=\"page-break-after: avoid;\"><span class=\"f_ControlHeading\">Publish<\/span><\/p>\n\r<p class=\"p_ControlIndent\"><span class=\"f_ControlIndent\">After creating a rule, click <\/span><span class=\"f_ControlIndent\" style=\"font-weight: bold;\">Publish<\/span><span class=\"f_ControlIndent\"> if you wish to copy that rule to every other user account belonging to this account\'s domain. You will be asked to confirm your decision to copy the rule to the other accounts.<\/span><\/p>\n\r"
})
