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
| Operator | Description | Example | Copy |
|---|---|---|---|
from: | Find emails from a specific sender | from:john@example.com | |
to: | Find emails sent to a specific recipient | to:jane@example.com | |
cc: | Find emails where someone was CC'd | cc:team@example.com | |
bcc: | Find emails where someone was BCC'd | bcc:manager@example.com | |
deliveredto: | Find emails delivered to a specific address | deliveredto:me@example.com |
Date Filters
| Operator | Description | Example | Copy |
|---|---|---|---|
after: | Find emails after a specific date | after:2024/01/01 | |
before: | Find emails before a specific date | before:2024/12/31 | |
older: | Find emails older than a time period | older:7d | |
newer: | Find emails newer than a time period | newer: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
| Operator | Description | Example | Copy |
|---|---|---|---|
label: | Find emails with a specific label | label:work | |
category: | Find emails in a category (primary, social, promotions, updates, forums) | category:promotions | |
in: | Find emails in a specific location | in:inbox | |
is:starred | Find starred emails | is:starred | |
is:important | Find emails marked as important | is:important | |
is:unread | Find unread emails | is:unread | |
is:read | Find read emails | is:read | |
is:snoozed | Find snoozed emails | is:snoozed |
Attachments
| Operator | Description | Example | Copy |
|---|---|---|---|
has:attachment | Find emails with any attachment | has:attachment | |
has:drive | Find emails with Google Drive attachments | has:drive | |
has:document | Find emails with Google Docs attached | has:document | |
has:spreadsheet | Find emails with Google Sheets attached | has:spreadsheet | |
has:presentation | Find emails with Google Slides attached | has:presentation | |
filename: | Find emails with attachments matching a filename | filename:report.pdf | |
filename:pdf | Find emails with PDF attachments | filename:pdf |
Size Filters
| Operator | Description | Example | Copy |
|---|---|---|---|
size: | Find emails larger than a size in bytes | size:5000000 | |
larger: | Find emails larger than a specified size | larger:10M | |
smaller: | Find emails smaller than a specified size | smaller:1M |
Content Search
| Operator | Description | Example | Copy |
|---|---|---|---|
subject: | Find emails with specific words in the subject | subject:meeting | |
"exact phrase" | Find emails containing an exact phrase | "quarterly report" | |
OR | Find emails matching either term | from:alice OR from:bob | |
- | Exclude emails matching a term | -from:newsletter@example.com | |
AROUND | Find words near each other (within n words) | budget AROUND 5 approval |
Special Filters
| Operator | Description | Example | Copy |
|---|---|---|---|
list: | Find emails from a mailing list | list:team@groups.example.com | |
rfc822msgid: | Find email by Message-ID header | rfc822msgid:abc123@mail.example.com | |
has:userlabels | Find emails with any user-created label | has:userlabels | |
has:nouserlabels | Find emails without user-created labels | has:nouserlabels | |
is:muted | Find muted conversations | is:muted |