Search operators
Gmail's search operators, such as from:, has:attachment or older_than:, work in Courant for every account, on the device and on the server.
On this page
Courant understands Gmail's search language for all your accounts, Outlook, iCloud, IMAP and Fastmail ones included. Type operators in the search field, in Advanced Search's Edit Query, in a saved search's Edit…, or in Open Quickly… on the Mac. Advanced Search shows the operators of the search you build under Query: a good way to learn them.
The operators
| Operator | Finds | Example |
|---|---|---|
| words | Emails with all these words | lunch friday |
"…" | This exact phrase | "quarterly report" |
from: | Emails from a person, an address or a domain; me is you | from:lisa, from:example.com |
to:, cc:, bcc: | Emails sent to them | to:me |
subject: | Words in the subject | subject:invoice |
has:attachment | Emails with an attachment | has:attachment |
filename: | An attachment's name or extension | filename:pdf, filename:contract.docx |
is:unread, is:read, is:starred, is:important | By state | is:unread |
in: | A mailbox: inbox, sent, drafts, spam, trash, starred, anywhere; or a label or folder | in:sent, in:anywhere |
label: | A label or a folder | label:clients |
category: | primary, social, promotions, updates, forums | category:promotions |
after:, before: | Dates, written 2026/11/01 or 2026-11-01 | after:2026/01/01 before:2026/02/01 |
newer_than:, older_than: | A time back from today, in days (d), months (m) or years (y) | newer_than:7d, older_than:1y |
larger:, smaller: | A size, in bytes, k or M | larger:10M |
list: | Emails from a mailing list | list:news@example.com |
Combine them
- A space between terms: all of them must match.
from:lisa has:attachment OR(in capitals): either one.from:lisa OR from:paul{…}: any of the terms inside.{from:lisa from:paul}-before a term leaves it out.invoice -from:amazon(…)groups terms.subject:(dinner party)
Spam and Trash are left out unless the search says in:spam, in:trash or in:anywhere.
Gmail's own operators
has:drive, has:document, has:spreadsheet, has:presentation, has:youtube, has:userlabels, has:nouserlabels, deliveredto:, rfc822msgid: and AROUND are Gmail's. For a Gmail account, Gmail's server answers them, even when you search This Device (the device then has no instant results to show first).
With Outlook, iCloud, IMAP and Fastmail accounts
These accounts don't have Gmail's tabs or its Important marker, so Courant reads those operators as what they have:
| Operator | Means |
|---|---|
is:important | Outlook: the Focused Inbox. Other accounts: left out, the rest of the search applies. |
category:primary | Outlook: the Focused Inbox. Other accounts: emails Courant doesn't sort as Social, Promotions, Notifications or Newsletters. |
category:social, promotions, updates, forums | Courant's categories Social, Promotions, Notifications and Newsletters (see Categories). |
label:, in: | A folder, by its name. |
Their servers don't understand every operator. Courant asks them what they can, then keeps only the emails that truly match, using what it knows of them on the device.