Gmail Search Operators

Search operators to filter and find emails in Gmail with precision.

39 operators across 7 categories

Tips & Notes

  • Combine multiple operators with spaces (implicit AND) or use OR between terms.
  • Use parentheses to group complex queries: (from:alice OR from:bob) has:attachment
  • Gmail search is not case-sensitive.
  • Wildcards (*) work in some contexts but not all operators.
  • Negative operators (minus sign) exclude results: -from:newsletter@example.com

Sender & Recipient

OperatorDescriptionExampleCopy
from:Find emails from a specific senderfrom:john@example.com
to:Find emails sent to a specific recipientto:jane@example.com
cc:Find emails where someone was CC'dcc:team@example.com
bcc:Find emails where someone was BCC'dbcc:manager@example.com
deliveredto:Find emails delivered to a specific addressdeliveredto:me@example.com

Date Filters

OperatorDescriptionExampleCopy
after:Find emails after a specific dateafter:2024/01/01
before:Find emails before a specific datebefore:2024/12/31
older:Find emails older than a time periodolder:7d
newer:Find emails newer than a time periodnewer:2d
older_than:Find emails older than a relative time (d/m/y)older_than:1y
newer_than:Find emails newer than a relative time (d/m/y)newer_than:1m

Labels & Categories

OperatorDescriptionExampleCopy
label:Find emails with a specific labellabel:work
category:Find emails in a category (primary, social, promotions, updates, forums)category:promotions
in:Find emails in a specific locationin:inbox
is:starredFind starred emailsis:starred
is:importantFind emails marked as importantis:important
is:unreadFind unread emailsis:unread
is:readFind read emailsis:read
is:snoozedFind snoozed emailsis:snoozed

Attachments

OperatorDescriptionExampleCopy
has:attachmentFind emails with any attachmenthas:attachment
has:driveFind emails with Google Drive attachmentshas:drive
has:documentFind emails with Google Docs attachedhas:document
has:spreadsheetFind emails with Google Sheets attachedhas:spreadsheet
has:presentationFind emails with Google Slides attachedhas:presentation
filename:Find emails with attachments matching a filenamefilename:report.pdf
filename:pdfFind emails with PDF attachmentsfilename:pdf

Size Filters

OperatorDescriptionExampleCopy
size:Find emails larger than a size in bytessize:5000000
larger:Find emails larger than a specified sizelarger:10M
smaller:Find emails smaller than a specified sizesmaller:1M

Content Search

OperatorDescriptionExampleCopy
subject:Find emails with specific words in the subjectsubject:meeting
"exact phrase"Find emails containing an exact phrase"quarterly report"
ORFind emails matching either termfrom:alice OR from:bob
-Exclude emails matching a term-from:newsletter@example.com
AROUNDFind words near each other (within n words)budget AROUND 5 approval

Special Filters

OperatorDescriptionExampleCopy
list:Find emails from a mailing listlist:team@groups.example.com
rfc822msgid:Find email by Message-ID headerrfc822msgid:abc123@mail.example.com
has:userlabelsFind emails with any user-created labelhas:userlabels
has:nouserlabelsFind emails without user-created labelshas:nouserlabels
is:mutedFind muted conversationsis:muted