Thunderbird stayed independent and free through its 2026 release cycle, and message filters are still the feature that turns a noisy inbox into a self-sorting one — no add-on, no subscription. I built a filter last week that drops every GitHub notification straight into a Code folder and marks it read, so the inbox only shows mail an actual person sent. Here is how to set up Thunderbird message filters from scratch: where the dialog lives, how conditions and actions fit together, how to run a rule on a folder you already have, and the order filters fire in so they never fight each other.
What Message Filters Do
A Thunderbird message filter is a rule that watches incoming mail and acts on it automatically — moving it to a folder, tagging it, marking it read, forwarding it, or deleting it. Filters are stored per account and run on new mail by default, but you can also run them on demand against a folder you already have.
A filter is the difference between sorting mail and mail sorting itself. Without one, every newsletter, receipt, and notification lands in the inbox and you decide its fate by hand, message by message. With one, the decision is made once — when you write the rule — and Thunderbird applies it forever, silently, before you even open the program.
Mozilla describes the goal plainly: filters let you “organize your messages” so mail goes where it belongs without your involvement. The official help confirms a filter can move messages to folders, delete them, and forward them, among other actions. The point is leverage: an hour spent writing a dozen good filters saves a few minutes every single day, indefinitely. That is the same automation logic behind a Gmail filter that deletes automatically — write once, runs forever.
Open the Filters Dialog
Open Tools > Message Filters from the menu bar, or click the application menu button and choose Tools, then Message Filters. At the top of the dialog, select the account the filter should belong to — filters are saved per account, so a rule built under one address does not apply to another.
The single most common setup mistake is building a filter under the wrong account. Thunderbird does not have one global filter list; each account carries its own. So before anything else, look at the dropdown at the top of the Message Filters window and confirm it names the account whose mail you want to sort.
If the classic menu bar is hidden, the same path lives behind the application menu button (the three-line icon): Tools → Message Filters. The window that opens lists every filter on the selected account, with buttons to create, edit, reorder, and run them. Nothing here touches the server — filters live in your local profile, which is why they behave the same whether you are on a fresh Thunderbird install or a years-old one.
Build the Conditions
Click New, name the filter, then build each condition from three parts: a Property such as From or Subject, a Test such as contains or is in my address book, and a Value such as an email address or keyword. Choose ‘Match all of the following’ for AND logic or ‘Match any of the following’ for OR, and add rows with the plus button.
The condition is the “if” half of the rule. Per Mozilla, every condition is three components: a Property (“a message element or characteristic such as ‘Subject’ or ‘From’”), a Test (“a check on the property, such as ‘contains’ or ‘is in my address book’”), and a Value (“a specific detail, such as an email address or keyword”). Read left to right, a condition is a sentence: From contains github.com, or Subject contains invoice.
Two choices decide how multiple conditions combine:
- Match all of the following — every condition must be true (AND). Use it to be precise: From contains stripe.com and Subject contains receipt.
- Match any of the following — one condition is enough (OR). Use it to catch variants: From contains newsletter or From contains noreply.
Add or remove rows with Add a new rule (+) and Remove this rule (–). Start loose with contains and Match any while testing, then tighten to is and Match all once the rule catches what you want and nothing you do not. Over-strict conditions are the number-one reason a filter quietly does nothing.
Choose the Actions
The action is what the filter does to a matching message: Move Message to a folder, Copy Message, Mark As Read, Add Tag or star, Forward Message, Set Priority, or Delete. You can stack several actions on one filter — for example move to a folder and mark as read in the same rule.
Conditions decide which messages; actions decide what happens to them. The actions that earn their keep:
- Move Message to a folder — the workhorse. Send mail straight to its home so the inbox stays for things that need you.
- Mark As Read — pair with Move so routed mail never shows an unread badge.
- Add Tag / add a star — color-code without moving, useful when you still want the mail in the inbox but flagged. The tag feature is what one Thunderbird user singles out: “I tag something important and find it quickly”.
- Forward Message to an address — auto-relay receipts to an accountant, for instance.
- Delete — for true junk you never want to see; use sparingly, because deletion is irreversible once the trash empties.
Stack them freely. The combination I use most is Move Message to → Newsletters plus Mark As Read in one filter, so promotional mail is filed and silenced in a single pass. This is the same one-rule-many-actions thinking behind Outlook rules automation — Thunderbird just exposes it more simply.
Run a Filter on a Folder
To apply a filter to messages already in a folder rather than only to new mail, open Tools > Message Filters, select the folder from the list, and click Run Now. By default filters fire on incoming mail under ‘Getting New Mail’, but Run Now applies them retroactively — the way to sort a backlog in one pass.
A new filter only catches mail that arrives after you create it. Existing messages sit untouched unless you tell Thunderbird to process them. That is what Run Now is for: in the Message Filters dialog, choose the folder you want to clean, then click Run Now and the selected filters sweep through everything already there.
This is how you tame a backlog. Build the rule, point it at the cluttered inbox, run it once, and a thousand newsletters move to their folder in seconds. You can also set when a filter runs under Apply filter when: Getting New Mail (the default, for incoming), After Sending (for outgoing), and Archiving. For most people, Getting New Mail plus an occasional Run Now covers everything.
Filter Order
Filters run in the order they appear in the Message Filters list, top to bottom, and the first matching rule acts before later ones see the message. Move specific filters above general ones with the Move Up button so they fire first; Thunderbird shows a ‘See execution order’ note when an action changes the real sequence.
Order matters because filters do not all get a turn. Mozilla states that “filters are executed in the order they appear in the list”, and a rule that moves a message out of the inbox can stop a later rule from ever matching it. So sequence is logic, not cosmetics.
The rule of thumb: specific before general. A filter that catches one important sender should sit above a broad “move all newsletters” sweep, or the broad rule may grab the message first. Reorder with Move Up / Move Down. When an action forces a different real-world order, Thunderbird flags it with a See execution order link so you can verify what actually happens. Getting order right is what stops a spam filter setup from accidentally eating mail you wanted to keep.
Three Filters Worth Building
Three filters cover most of the noise: route newsletters to a folder and mark them read, tag mail from key people so it stands out, and forward receipts to an archive or accountant. Each is a single rule with one condition and one or two actions, built in under a minute.
Start with these and you will feel the difference the first morning:
- Newsletters → folder, marked read. Condition: From contains newsletter or List-Id exists. Actions: Move Message to “Newsletters” + Mark As Read. The inbox stops showing bulk mail at all.
- VIP tagging. Condition: From is in my address book or From is [your boss’s address]. Action: Add Tag “Important”. Key mail is color-flagged the instant it lands.
- Receipts → forwarded and filed. Condition: Subject contains receipt or invoice. Actions: Move Message to “Receipts” + Forward Message to your accountant. Bookkeeping mail handles itself.
Build these three, run each once with Run Now to clean the backlog, and the inbox becomes a list of things that genuinely need you. If you are comparing clients on how well they automate this, see the best email clients for Windows in 2026 and the Thunderbird alternatives roundup.
Where It Breaks
Filters fail in predictable ways: a rule built under the wrong account, a condition too strict to ever match, an earlier filter that already moved the message, or expecting filters to sync across devices — they do not, because they live in the local profile, not on the server.
No filter setup is fully fire-and-forget. The honest failure modes:
- Wrong account. The most common silent failure: the rule exists, just under an account whose mail it never sees. Check the dropdown at the top of the dialog.
- Too strict. Match all with three exact conditions can be impossible to satisfy. Loosen to Match any and contains while testing, then tighten.
- Order conflict. An earlier filter moved or deleted the message before yours got a turn. Move the specific rule up.
- No sync. Filters are stored locally in the account profile, not on the mail server, so they do not follow you to your phone or a second computer. Copy the profile’s msgFilterRules.dat file or rebuild them per device.
When a filter does nothing, do not rewrite it blind — open Message Filters, select the folder, and hit Run Now to watch whether it acts. That one test isolates almost every cause.
Verdict
Thunderbird message filters are a per-account, local rule engine: build a condition from Property, Test, and Value, attach actions like Move and Tag, keep specific rules above general ones, and use Run Now to sort folders you already have. Three or four good filters do most of the work, for free, forever.
Best for: anyone whose Thunderbird inbox mixes newsletters, receipts, and notifications with mail that actually needs a reply. A handful of action-based filters separates the noise from the signal automatically, and the setup outlives every inbox cleanup you would otherwise repeat by hand.
Skip if: you need the same rules on multiple devices and refuse to copy a profile file — Thunderbird filters are local, so server-side rules in your webmail are the better fit for true cross-device sync.
Start with one filter — newsletters to a folder, marked read — confirm it with Run Now, then add VIP tagging and receipt forwarding. Keep specific rules above general ones, and your inbox sorts itself before you ever open it.

Alexis Dollé, email expert for 10+ years. Founder of Email Tools. I test every email client and utility myself, then write about them the way I’d explain them to a friend — no marketing fluff, no sponsored rankings, every claim sourced.
LinkedInSources & references
- Mozilla Support, “Organize your messages by using filters” — Tools > Message Filters, the New button and Filter Rules dialog, conditions as Property/Test/Value, “Match all/any of the following”, actions to move/delete/forward, and Run Now to apply filters to existing messages; “filters are executed in the order they appear in the list”. Accessed 2026-06-19. support.mozilla.org — Organize your messages by using filters
- Thunderbird.net, “Features” — “Filter and organize the way you like” and the tag feature highlighted by a user: “I tag something important and find it quickly.” Accessed 2026-06-19. thunderbird.net — Features
Frequently Asked Questions
How do I set up message filters in Thunderbird?
Go to Tools > Message Filters, pick the account, click New, name the filter, then build a condition from a Property (such as From), a Test (such as contains), and a Value (an address or keyword). Choose an action — Move Message to a folder, Add Tag, Mark As Read, or Delete — and save. New mail is filtered automatically; click Run Now to apply the rule to messages already in a folder.
Why are my Thunderbird filters not working?
The three usual causes: the filter belongs to the wrong account (filters are stored per account, so check the dropdown at the top of the Message Filters dialog), the rule sits below another filter that already moved or deleted the message (filters run top to bottom and the first match can stop later ones), or the condition is too strict — “Match all” requires every rule to be true. Switch to “Match any”, loosen the test from “is” to “contains”, and run it manually with Run Now to confirm.
Can a Thunderbird filter run on existing messages, not just new mail?
Yes. Open Tools > Message Filters, select the folder you want to clean from the list, and click Run Now. By default a filter applies to incoming mail under “Getting New Mail”, but Run Now applies it retroactively to whatever is already in the chosen folder, which is how you sort a backlog in one pass.
In what order do Thunderbird filters run?
Filters run in the order they appear in the Message Filters list, top to bottom, and the first matching rule can act before later ones see the message. Move the most specific or most important filters to the top with the Move Up button. If an action makes the listed order impossible, Thunderbird shows a “See execution order” note explaining the actual sequence.
What actions can a Thunderbird filter perform?
A single filter can move or copy a message to a folder, mark it as read, add a tag or star, forward it to another address, set its priority, or delete it — and you can stack several actions on one rule. A common combination is move to a Newsletters folder plus mark as read, so promotional mail never touches the inbox.
Do Thunderbird filters sync across devices?
No. Message filters are stored locally in the account’s profile, not on the mail server, so a rule you build on your laptop does not appear on your phone or a second computer. To replicate them, copy the account’s msgFilterRules.dat file between profiles, or rebuild the same filters on each device. Server-side rules in your webmail are the only ones that follow the account everywhere.
Related: Thunderbird spam filter setup — the junk-classification layer that pairs with these rules. How to migrate to Thunderbird — get set up before you automate. Thunderbird calendar setup — the other half of a complete Thunderbird workflow.