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.

Mac · iPhone · iPad

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

OperatorFindsExample
wordsEmails with all these wordslunch friday
"…"This exact phrase"quarterly report"
from:Emails from a person, an address or a domain; me is youfrom:lisa, from:example.com
to:, cc:, bcc:Emails sent to themto:me
subject:Words in the subjectsubject:invoice
has:attachmentEmails with an attachmenthas:attachment
filename:An attachment's name or extensionfilename:pdf, filename:contract.docx
is:unread, is:read, is:starred, is:importantBy stateis:unread
in:A mailbox: inbox, sent, drafts, spam, trash, starred, anywhere; or a label or folderin:sent, in:anywhere
label:A label or a folderlabel:clients
category:primary, social, promotions, updates, forumscategory:promotions
after:, before:Dates, written 2026/11/01 or 2026-11-01after: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 Mlarger:10M
list:Emails from a mailing listlist: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:

OperatorMeans
is:importantOutlook: the Focused Inbox. Other accounts: left out, the rest of the search applies.
category:primaryOutlook: the Focused Inbox. Other accounts: emails Courant doesn't sort as Social, Promotions, Notifications or Newsletters.
category:social, promotions, updates, forumsCourant'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.