Using Saved Searches

What are Saved Searches?

Saved searches are groups of search parameters for searches that run continuously on incoming messages, filtering messages that meet the search criteria into a folder. They are an efficient way to save time and typing on searches you run frequently.

When you create a saved search, you can select search criteria such as email addresses, keywords and dates. Thunderbird then creates a folder that stores messages that meet your criteria. Once created, new messages will be automatically added to the folder as they are received.

For example, you might keep messages from your high-school friends in a folder called “Highschool.” You could then add your high school friends’ names to a saved search so they would be automatically added to the “Highschool” folder as they arrive.

How to create a Saved Search folder

  1. From the File menu, click New, and then Saved Search from the sub-menu. The New Saved Search Folder dialog appears.
    New saved-search dialog
  2. Click the Create as a subfolder of dropdown if you wish to change the parent folder. The folder that was selected when you opened the saved-search dialog in Step 1 will be displayed as the default name and location of the new saved search folder.
  3. To select the folders to search, click the Choose button. A dialog will be displayed that contains a hierarchical view of all the mail folders in all of your accounts. Select the check box next to each folder you wish to include in the search.
    folder selection dialog for saved searches
    TIP: If you want to include a number of folders that are next to each other in the list, you can multi-select them. Click on the row of the first folder (not in the check box), then press Shift and click on the last folder. Then press the Spacebar to select the check box for all of the highlighted folders (pressing Spacebar again clears the check boxes).
    NOTE: You can include as many folders as you like in your saved search, but each folder you add will cause the search to take longer. Only select the folders that you need.
  4. If your messages are not stored on your local system for offline access (for example, if they are stored on a central IMAP server), check Search Online. This is only necessary if you are filtering based on the body of the message, as addresses and the subject line are stored locally even if you leave the message body on the server.
    TIP: In most cases, searching online is unnecessary and will slow your search down. An offline search is conducted locally on your computer, while an online search uses your mail server to do the search. Offline searches are much faster and Thunderbird's auto-sync mechanism automatically keeps your folders up-to-date.

How to set the search criteria

  1. Choose one of three search modes:
    • Match all of the following: This creates an "and" query where all of the listed rules must apply for the message to be shown in the folder.
    • Match any of the following: This creates an "or" query where if any of the listed rules match a message, then the message will be shown in the folder.
    • Match all messages: This means you have no search criteria and are just using the saved search to combine the contents of multiple folders and display them as a single folder.
  2. Choose your criteria.
    The filter criteria, also known as "rules", are each made up of three parts:
    • A property, for example “From”
    • A test, for example “Contains”
    • A value, for example “”
This example matches messages from “”.
The tests and values will vary depending on the property you select.

Example searches

Saved searches are especially useful if you regularly receive a large number of messages, and have an ongoing need to quickly pick out those of special interest.

  • Example 1: You regularly receive messages from workplace colleagues that include important work-related documents as attachments. You could create this search:

attachments example for saved searches

Your new saved search folder “Unread work attachments” will contain all messages that are unread, have attachments, and were sent from the "MyWorkplace" domain. All future messages meeting all three criteria will show up in your new folder as well.

  • Example 2: You like to filter out lower-priority messages to reduce clutter. For example you may have chosen to receive notifications from businesses you patronize, but like to quickly read and dispose of those messages. You could create a saved search like this:

promotions example for saved searches

Your new saved search folder “Promotional Stuff” will contain any messages that are from the address “”, OR have “discount” in the subject line, OR have the word “customer” somewhere in the address or display name (“customer.service”, “Customer Support” etc.) After a quick read you can then delete those messages individually.

NOTE: Deleting individual messages in a saved search folder will remove them from Thunderbird entirely. Deleting the saved search folder itself, however, will NOT remove the original messages it displayed. This feature allows you to delete any saved searches you no longer need without having to worry about losing the messages.


The most commonly used properties are described below.

Properties dropdown for saved searches

The following properties refer to the email message “headers” (as opposed to content in the body of the message):

  • From
  • To
  • Cc
  • To or Cc
  • From, To, Cc or Bcc

The sender and recipient properties can contain one or more email addresses, and sometimes also a display name. In the example "John Doe" <>, "John Doe" is the display name, and "" is the email address. When you enter the value for the search, Thunderbird will search for the value in both the display name and the email address. For example, if your filter is:

From | Is | ""

Thunderbird checks if the display name "John Doe" is the same as "" (which fails) and also if the email address is the same as "" (which succeeds).

TIP: Using the email address in a filter is more accurate than using the display name. The author of the email provides the display name, and sometimes the display name will be omitted or different from the address.

Searches are case-insensitive, so capitalization does not matter. If the sender of the message used "", it would still succeed when compared with our test value of "". Searches on display names are also case-insensitive.

TIP: In addition to checking messages for specific individuals, you can also use this filter to see if people involved in the message list are in your address book or not. Use the “is in my address book” / “is not in my address book” for the test, then specify an address book as the value. If you create a custom address book with relevant names, you can use this to specify a group of people in a saved search without adding them individually.


Tags are used to mark messages with a special designation and highlight color. Thunderbird provides the tags Important, Work, Personal, To Do, and Later, as well as the ability to create custom tags.

Contains: Succeeds if the tag is present on the message.

Doesn't Contain: Succeeds as long as the tag is not present on the message.

Is: Succeeds if the message has only the specified tag present. So if your filter is Tag | Is | Important, a message tagged with "Important" and "Work" would not match until the "Work" tag is removed.

Isn’t: Fails if the message has only the specified tag present. So if your filter is Tag | Isn’t | Important, then a message tagged with "Important" and "Work" would match until the "Work" tag is removed, at which point it would fail to match.

IsEmpty: Succeeds if the message has no tags applied.

Isn’tEmpty: Succeeds if the message has any tags applied.

NOTE: Starred and unstarred messages are checked by adding the filter Status | Is (or Isn't) | Starred.


This lets you check the subject of a message. It will include the "Re: " prefix if one is present, but ignores capitalization.


This lets you check for the presence of a word or phrase in the message body. These searches are subject to some important limitations:

  • Saved searches do not support “word stemming,” the functionality that removes or transforms suffixes so that different variations of a word will all match. For example, "runner", "runs", and "running" all stem to the same root (“run”), but in saved searches only the specified word will match. (Thunderbird’s Global Search supports stemming.)
  • Saved searches will not search across line breaks in the message. For example, if you want to search for the phrase "let's party!", it will only match as long as the complete phrase appears in a single line of the message.
  • Searching the body of a message can be time-consuming. Thunderbird has to read the contents of a message from the hard drive.

Date and Age in Days

The Date property lets you check the date of the message (as provided by the author of the message, not when you received it) against a specific date you provide as the value.

The Age in Days property lets you check the age of the message (using the date provided by the author of the message, not when you received it). The age is always calculated using the instant the message is checked for a match.

Attachment Status

The Attachment Status property lets you check whether messages have attachments (by using Is | Has Attachments) or have no attachments (by using Isn’t | Has Attachments) .

NOTE: If your saved search includes messages that are stored on a remote server, as opposed to your local system, Thunderbird may not be entirely accurate with this analysis. The software does not know specific details about messages until the messages are downloaded, which occurs when you click on a message.

Tests and values

Is / isn't: Checks if either the display name or email address match the value provided in the filter, ignoring differences in capitalization. Use this to match specific email addresses.

Is in my address book / isn't in my address book: Use this to match multiple email addresses, and possibly as a shorthand for people whose messages are important to you. For the value, choose between Personal Address Book and Collected Addresses:

  • Personal Address Book is made up of addresses which are added when you click the star next to the sender’s name in the message reader.
  • Collected Addresses is made up of all the people you have sent messages to on the computer you’re currently using. Thunderbird maintains this list automatically.
NOTE: On Mac OS X, the system address book may also be present.

Ends with: Checks if the display name or email address ends with the provided value, ignoring differences in capitalization. You might use this with something like "" to match all the email addresses from a single domain.

Begins with: Checks if the display name or email addres starts with the provided value, ignoring difference in capitalization. You might use this with something like "webmaster@" to match emails to webmasters across multiple domains.

Contains / doesn't contain: Checks if the provided value can be found anywhere in the display name or email address, ignoring differences in capitalization. Use this test cautiously because it can often match things you don't actually want it to match. Consider using "is" or "ends with" instead.

See Also

Global Search

Open Search

Configuration Options for Search

Share this article:

Was this article helpful? Please wait...

These fine people helped write this article: pollti. You can help too - find out how.