Apple Mail Advanced Search in 2026: Operators and Smart Mailboxes

Find any email in Apple Mail on a Mac: search tokens like from: and priority:, AND, OR and NOT, date ranges, filters and self-updating Smart Mailboxes.

The Merlin team11 min read

Apple Mail on a Mac searches with more than plain keywords. In the toolbar search field you can type a header such as from: or priority: high, a date range like 04/02/23 to 04/19/23, the words flag, unread or attachment, and the operators AND, OR and NOT in capitals. Save a search you repeat as a Smart Mailbox under Mailbox > New Smart Mailbox.

The search field looks so plain that it's easy to assume it only matches words, so a missing email turns into ten minutes of scrolling. Below is every search token Apple documents in its Mail User Guide for macOS 27, how to stack them, how to turn a search you keep repeating into a Smart Mailbox, and the usual reasons Mail can't find a message you know is there.

Apple Mail search operators at a glance

Apple Mail understands six kinds of advanced search input on a Mac: message headers, date ranges, status words, Boolean operators, a minus sign to exclude, and plain-language requests. Apple's search guide gives the examples in the table; the right-hand column is what each one is good for in practice.

Apple Mail search syntax on a Mac (macOS 27)

What you type

Apple's example

What it finds

A header, a colon, a value

from: Ashley Rico

Mail from that sender only, not every message that mentions the name

The priority header

priority: high

Messages the sender marked high priority

A date range

04/02/23 to 04/19/23

Messages from those dates

A status word

flag, unread or attachment

Flagged, unread, or attachment-carrying messages

Boolean operators, in capitals

yellowstone AND cascades NOT teton

Both words, minus anything with the third

A minus sign

cascade AND yellowstone -teton

The same exclusion, typed faster

Plain language

NYC business trip

Results based on what you mean, not only the exact words

The capitals matter. Apple's guide says the Boolean operators go in uppercase; in lowercase, "and" and "not" are just more words to match.

How to search in Apple Mail on a Mac

To search Apple Mail on a Mac, type in the search field in the toolbar and pick one of the suggestions Mail offers as you type. Choosing a suggestion turns your text into a search filter (a sender, a subject, an attachment) instead of a loose keyword. These steps follow Apple's search guide:

  1. Open Mail and select the mailbox you want to search in the sidebar, or leave the inbox selected.
  2. Start typing in the search field in the toolbar. If you don't see the field, click the Search button first.
  3. Pick a suggestion from the list, such as a person's name under the sender suggestions.
  4. Type more and pick a second suggestion to add another filter. Mail shows only messages that match every filter.
  5. If the current mailbox has no results, click Search all mailboxes below the search field.
  6. When you're done, click the Clear button in the search field to get your full mailbox back.

Mail's guide says the results that seem most relevant come first. In an older version of the guide, Apple explained that this ranking draws on the messages you've recently read and replied to, your VIPs and other signals, so the top of the list often has what you need without scrolling.

Change what a filter searches

Each filter Mail creates has a small down arrow. Click it to change the filter's scope, for example from the sender to the subject or to the whole message. This is the fix when a word appears in hundreds of message bodies but you only care about it in a subject line.

When I need the signed contract a client sent months ago, I type the client's name and pick the sender suggestion, then type attachment as a second filter. Two filters usually cut the list down to a handful of messages, which beats any amount of clever keyword guessing.

Search by sender, priority and other headers

To search a specific header in Apple Mail, type the header name, a colon and the value, such as from: Ashley Rico or priority: high. Apple's guide uses those two as its examples of searching by message header. The colon form tells Mail exactly which part of the message to look in.

The sender header is the one I use most. Typing a person's name alone matches every email that mentions them, including newsletters and long threads where they were only copied. Putting from: in front of the name limits the results to mail they actually sent you, which is usually the question.

The priority: high search is more niche. Plenty of senders never set a priority, so it mostly surfaces mail from the few people who do, not everything important.

Use AND, OR and NOT in Apple Mail

Apple Mail supports the Boolean operators AND, OR and NOT, typed in uppercase, plus a minus sign as a shortcut for NOT. Apple's own example, yellowstone AND cascades NOT teton, finds messages that mention both parks but not the third, and cascade AND yellowstone -teton does the same.

A few combinations that earn their keep at work:

  • OR for something that goes by two names, such as a project's code name and its public name.
  • NOT or the minus sign to drop the automated noise, such as a word that also appears in every notification from a tool you use.
  • AND when a single keyword is too common on its own, such as "invoice" next to a vendor's name.

When I search for a vendor's invoices, the first results are often their marketing emails, because the newsletter mentions invoices too. Adding a minus sign and a word only the newsletter uses, like "webinar", usually clears them out.

Search by date and status

Apple Mail searches a date range when you type two dates with "to" between them, in the form Apple shows: 04/02/23 to 04/19/23. Apple's example puts the month first.

For status, type flag, unread or attachment in the search field. Each one finds flagged, unread or attachment-carrying messages, and you can add a second filter, such as a sender, to narrow it further.

Mail also tries to read plain requests. Apple's guide says it can return results "based on what you mean," and offers a travel tip: search for the three-letter airport code of the city you're flying to, or a phrase such as "NYC business trip", to pull up itinerary emails. Before a trip I search the airport code rather than the airline's name, because the code shows up on flight confirmations whether they came from the airline or a booking site.

Narrow the message list with filters and sorting

Apple Mail's message filter is a quick way to hide everything except unread mail, VIPs or messages with attachments, without typing a search. Apple's guide covers both filtering and sorting in the same article:

  • Turn on the filter: click the Filter button above the message list, or choose View > Filter > Enable Message Filter. The default filter is Unread, and the button changes color while a filter is on.
  • Pick a different filter: choose View > Filter, or click and hold the Filter button, then select an option such as Only from VIP or Only Mail with Attachments.
  • Toggle it from the keyboard: Command-L turns the message filter on or off for the current mailbox, per Apple's Mail keyboard shortcuts.
  • Sort the list: choose View > Sort By, then pick an attribute such as From or Size and a sort order.

Sorting by size is the overlooked one. When my Mac warned me about storage, sorting a mailbox by size put the emails with the heaviest attachments at the top, which made deciding what to delete a lot faster.

How to create a Smart Mailbox in Apple Mail

A Smart Mailbox in Apple Mail is a saved set of conditions that gathers matching emails from across your mailboxes, without moving them. You create one with Mailbox > New Smart Mailbox, and it keeps updating as new mail arrives. Apple's Smart Mailbox guide gives these steps:

  1. In Mail, choose Mailbox > New Smart Mailbox.
  2. Enter a name for the Smart Mailbox.
  3. Click the first pop-up menu and choose a condition, such as From, Subject or Sender is member of group.
  4. Finish the condition with the menus and fields that appear. For From, choose contains or begins with and type a name; for Sender is member of group, choose a group from your contacts.
  5. Click the Add button (+) for another condition, or the Remove button (−) to drop one.
  6. With two or more conditions, choose whether a message must meet any or all of them.
  7. Select the checkbox to include matching messages from Trash or Sent, if you want them.
  8. Click OK. The Smart Mailbox appears under Smart Mailboxes in the sidebar.

To change it later, double-click the Smart Mailbox in the sidebar, or select it and choose Mailbox > Edit Smart Mailbox. To remove it, select it and choose Mailbox > Delete Mailbox. Apple notes that the emails it showed aren't deleted, because they never left their original mailboxes.

Mail also comes with one Smart Mailbox already made, called Today, which lists the emails you've viewed during the current day. If you can't see it, hover over the Smart Mailboxes heading in the sidebar and click the disclosure triangle.

Can you save a search straight to a Smart Mailbox?

Older versions of Mail had a Save button below the search field that turned your current search into a Smart Mailbox, as Apple's guide for macOS Catalina describes. Apple's current search guide doesn't mention one, so the dependable route on macOS 27 is to rebuild the search's conditions in Mailbox > New Smart Mailbox.

Smart Mailbox ideas worth setting up

The best Smart Mailboxes answer a question you ask your inbox every week. A few built only from the conditions Apple documents:

Smart Mailboxes built from Apple's documented conditions

Smart Mailbox

Conditions

Why it helps

One client

From contains the client's domain, with Sent included

Their emails and your replies in one place, across every account

Leadership

Sender is member of group, set to a contacts group of the people you report to

Mail from the people whose requests come first

Invoices

Subject contains "invoice", a second condition Subject contains "receipt", set to match any

Billing mail from every vendor, wherever rules filed it

A project

Subject contains the project name, plus From contains the partner's domain, set to match any

A running file for work that spans several people

I keep one for a single client, set to their email domain with Sent included. Seeing my own replies next to theirs is the point: before a call I can scan what I promised without opening a single thread.

Smart Mailboxes vs. rules

A Smart Mailbox only shows messages; a rule acts on them. Apple's mailbox guide recommends Smart Mailboxes when you want to organize messages without moving them around. Rules, set up under Mail > Settings > Rules (the path in Apple's article on missing messages), can do things like move incoming mail out of your inbox automatically, as the Smart Mailbox guide puts it. If you use a Gmail account in Apple Mail, Smart Mailboxes are the closest thing to Gmail labels: one message can show up in several views at once.

Why Apple Mail search can't find an email

When Apple Mail search misses a message you know exists, the cause is usually the search scope, a filter you left on, a disabled account or a mailbox that needs rebuilding. Go down this list from the top; the steps come from Apple's guide to missing messages and its Spotlight article:

  1. Widen the scope. Mail searches the mailboxes you have selected. Click Search all mailboxes below the search field, or select a different mailbox in the sidebar.
  2. Turn off the message filter. Choose View > Filter > Disable Message Filter, or press Command-L. A filter left on hides everything that doesn't match it.
  3. Check Trash and Junk. Select each in the sidebar. A message from a sender you blocked may have gone straight to Trash.
  4. Check the account is on. Choose Mail > Settings > Accounts, select the account and make sure Enable this account is selected.
  5. Check your categories. If you use Mail's categories, a message may be sitting under Transactions, Updates or Promotions. Apple's article shows how to turn them off from the View Options button in the toolbar by deselecting Show Mail Categories.
  6. Rebuild the mailbox. Select the mailbox in the sidebar, then choose Mailbox > Rebuild. Apple suggests this when search isn't working as you expect.
  7. Reindex Spotlight. As a last step, open Apple menu > System Settings > Spotlight (or Siri & Spotlight), click Search Privacy, add your disk, wait a few seconds, then remove it so Spotlight reindexes it.

The last time Mail came up empty on a receipt I knew existed, the cause was step 2: I had left the Unread filter on from the morning. Now Command-L is the first thing I press when a search looks too short.

A quick checklist for finding email faster in Apple Mail

  • Pick suggestions instead of pressing Return on raw text, so Mail builds filters.
  • Use from: whenever the question is "what did this person send me?"
  • Type operators in capitals: AND, OR, NOT.
  • Add a minus word to drop newsletters and notifications.
  • Search an airport code for travel confirmations.
  • Make a Smart Mailbox for any search you've run three times.
  • Press Command-L when results look suspiciously thin.

If you're still deciding whether Apple Mail should be your main mail app, our comparison of Gmail vs. Apple Mail covers accounts, features and privacy side by side.

Ask for the email instead of building the search

Some emails resist every operator because you can't remember who sent them or what they said. If that mail lives in a Gmail account, connect it to Merlin, which is our own app and runs on your Mac, then describe the email in chat ("the lease my landlord sent in the spring"), and Merlin looks for the thread in your mail. Press ⌥Space to ask from inside Apple Mail or any other app. Ask it to answer that email and you get a draft card to edit; the reply only goes once you say yes.

Get Merlin

Frequently asked questions

How do I do an advanced search in Apple Mail on a Mac?

Type in Mail's toolbar search field and pick a suggestion to create a filter, then add more filters to narrow it. You can also type headers like from: or priority: high, a date range, or AND, OR and NOT in capitals.

Does Apple Mail support Boolean search?

Yes. Apple Mail on a Mac supports AND, OR and NOT in uppercase, plus a minus sign before a word to exclude it, as in "yellowstone AND cascades -teton".

How do I search Apple Mail by date range?

Type two dates with "to" between them in the search field, such as 04/02/23 to 04/19/23. Mail shows messages from that period.

How do I search all mailboxes in Apple Mail?

Run your search, and if the current mailbox has no results, click "Search all mailboxes" below the search field. Otherwise Mail searches only the mailboxes selected in the sidebar or Favorites bar.

What is a Smart Mailbox in Apple Mail?

A Smart Mailbox is a saved set of conditions that collects matching emails from all your mailboxes without moving them. Create one with Mailbox > New Smart Mailbox; deleting it doesn't delete any email.

Why is Apple Mail search not finding emails?

Usually the search is limited to one mailbox, a message filter is on, or the account is disabled. Try Search all mailboxes, press Command-L to turn off the filter, then use Mailbox > Rebuild if it still fails.

you scrolled all the way down here

your next free moment starts in three minutes

getting started takes three minutes. sign in, and i'm on your to-dos, starting with who's waiting on you

you decide what comes after

Download for Mac Free forever. No credit card.