April 4, 2026
Gmail Search Operators: The Complete Guide (2026)
Every Gmail search command explained with real examples — find any email in seconds, even in a mailbox with 100,000 messages.
Gmail's search bar does a lot more than keyword matching. With search operators, you can pinpoint a specific email from years ago in seconds — filter by sender, date, attachment type, label, size, and dozens of other criteria.
The problem? Google doesn't surface most of these anywhere in the Gmail interface. This guide covers every operator that works in 2026, with copy-paste examples.
The Basics: How Gmail Search Works
Type any word or phrase in the Gmail search bar, and Gmail searches across the subject, body, sender name, and sender address of every email in your account (except Trash and Spam, unless you tell it otherwise).
Search operators are special commands you add to narrow results. They follow a simple pattern: operator:value with no space after the colon.
from:sarah filename:pdf after:2025/12/31 before:2026/02/01
People Operators
Search by who sent or received the email.
| Operator | What It Does | Example |
|---|---|---|
from: |
Emails from a specific sender | from:jane@company.com |
to: |
Emails sent to a specific person | to:client@example.com |
cc: |
Emails where someone was CC'd | cc:manager@company.com |
bcc: |
Emails where someone was BCC'd | bcc:team@company.com |
deliveredto: |
The actual delivery address (useful with aliases) | deliveredto:me+receipts@gmail.com |
from:sarah matches anyone named Sarah or with "sarah" in their address. Use the full address for precision.
Subject & Content Operators
| Operator | What It Does | Example |
|---|---|---|
subject: |
Search only the subject line | subject:invoice |
"exact phrase" |
Match an exact phrase | "quarterly report Q1" |
+ |
Match a word exactly (no synonyms) | +run (won't match "running") |
- |
Exclude a term | budget -draft |
OR |
Match either term (must be uppercase) | from:alice OR from:bob |
{ } |
Group terms (same as OR) | {from:alice from:bob} |
( ) |
Group operators together | subject:(urgent OR critical) |
AROUND |
Words near each other (within N words) | meeting AROUND 5 Tuesday |
Date Operators
Narrow results to a specific time period. Dates use the format YYYY/MM/DD.
| Operator | What It Does | Example |
|---|---|---|
after: |
Emails after a date | after:2026/01/01 |
before: |
Emails before a date | before:2026/04/01 |
older_than: |
Emails older than a relative period | older_than:6m (6 months) |
newer_than: |
Emails newer than a relative period | newer_than:2d (2 days) |
d = days, m = months, y = years. So older_than:1y finds everything older than one year.
Attachment Operators
Find emails with specific file types attached.
| Operator | What It Does | Example |
|---|---|---|
has:attachment |
Any email with an attachment | has:attachment from:boss |
has:drive |
Emails with Google Drive links | has:drive subject:shared |
has:document |
Emails with Google Docs attached | has:document |
has:spreadsheet |
Emails with Google Sheets | has:spreadsheet |
has:presentation |
Emails with Google Slides | has:presentation |
has:youtube |
Emails with YouTube links | has:youtube |
filename: |
Search by file name or extension | filename:pdf or filename:report.xlsx |
Size Operators
Find large emails eating up your storage, or tiny ones with no content.
| Operator | What It Does | Example |
|---|---|---|
larger: |
Emails larger than a size | larger:10M (over 10 MB) |
smaller: |
Emails smaller than a size | smaller:50K (under 50 KB) |
size: |
Emails of an exact size (rarely useful) | size:1048576 (exactly 1 MB, in bytes) |
larger:10M older_than:1y to find old, large emails you can delete to free up space. This is one of the fastest ways to clear Gmail storage.
Label & Location Operators
Search within specific folders, labels, or categories.
| Operator | What It Does | Example |
|---|---|---|
in:inbox |
Only inbox messages | in:inbox is:unread |
in:sent |
Only sent messages | in:sent to:client |
in:trash |
Only trashed messages | in:trash subject:invoice |
in:spam |
Only spam messages | in:spam from:newsletter |
in:anywhere |
Search everything including Trash and Spam | in:anywhere receipt |
label: |
Search within a label | label:work-projects |
has:nouserlabels |
Emails with no labels applied | has:nouserlabels in:inbox |
category: |
Gmail category tabs | category:promotions or category:updates |
Status Operators
Filter by read/unread, starred, snoozed, and more.
| Operator | What It Does | Example |
|---|---|---|
is:unread |
Unread emails only | is:unread from:boss |
is:read |
Read emails only | is:read label:follow-up |
is:starred |
Starred emails | is:starred older_than:30d |
is:important |
Emails marked important | is:important is:unread |
is:snoozed |
Snoozed emails | is:snoozed |
has:userlabels |
Emails with any user label | has:userlabels in:inbox |
is:muted |
Muted conversations | is:muted |
Advanced: Header & Delivery Operators
These are less common but powerful for troubleshooting email issues or catching phishing.
| Operator | What It Does | Example |
|---|---|---|
list: |
Emails from a mailing list | list:dev-team@company.com |
Rfc822msgid: |
Find email by Message-ID header | Rfc822msgid:abc123@mail.gmail.com |
has:blue-info |
Emails with a verified sender blue checkmark | has:blue-info |
10 Real-World Search Recipes
Copy-paste these into your Gmail search bar. They cover the most common "how do I find that email?" scenarios.
1. Find that invoice from last quarter
subject:invoice after:2026/01/01 before:2026/04/01 has:attachment
2. Find all unread emails from your boss
from:boss@company.com is:unread
3. Find large attachments eating your storage
larger:15M older_than:6m
4. Find emails you sent but never got a reply to
in:sent -in:inbox subject:follow after:2026/03/01
5. Find all PDFs from a specific person
from:accountant@firm.com filename:pdf
6. Find unsubscribe links (bulk newsletter cleanup)
unsubscribe category:promotions older_than:3m
7. Find emails about meetings this week
subject:(meeting OR standup OR sync) newer_than:7d
8. Find emails with Google Drive links from your team
has:drive from:(@company.com) newer_than:30d
9. Find everything in Trash before permanently deleting
in:trash subject:important OR subject:contract OR subject:agreement
10. Find emails with images (photos, screenshots)
filename:jpg OR filename:png OR filename:heic newer_than:30d
Combining Operators Like a Pro
The real power comes from combining operators. Here are the rules:
- AND is implicit:
from:alice subject:budgetmeans from Alice AND subject contains "budget" - OR must be uppercase:
from:alice OR from:bob - Minus excludes:
from:alice -subject:newsletter(from Alice, but not newsletters) - Parentheses group:
from:alice (subject:budget OR subject:forecast) - Quotes for exact phrases:
"end of quarter review"
You can stack as many operators as you need. Gmail processes them left to right.
Limitations of Gmail Search
Gmail's search is powerful but not perfect. A few things to know:
- No regex support: You can't use regular expressions. Wildcards (
*) work in some cases but inconsistently. - Trash & Spam excluded by default: Unless you add
in:trash,in:spam, orin:anywhere, those folders are skipped. - Slow on huge mailboxes: Accounts with 200K+ emails can experience noticeable lag in the web interface.
- No body-only search: There's no operator for "search only the email body" — it always includes subject and sender.
- Recent emails may lag: Very new emails (last few minutes) might not appear in search results immediately.
If you regularly search a large mailbox and find Gmail's web search too slow, a desktop email client that syncs locally can be significantly faster — it searches your local database instead of waiting for Google's servers.
Save Searches as Filters
If you run the same search frequently, turn it into a Gmail filter to automate actions:
- Run your search in Gmail
- Click the filter icon (right side of search bar) or the Show search options dropdown
- Click Create filter at the bottom
- Choose actions: auto-label, archive, forward, mark as read, etc.
Filters run on incoming emails that match your search criteria. They don't retroactively process old emails unless you check "Also apply filter to matching conversations."
Search Your Gmail Faster
ChainMail syncs your Gmail locally and searches your entire mailbox offline — no server round-trips, no lag on large accounts. Same search operators, faster results.
Try ChainMail FreeFrequently Asked Questions
How do I search for emails from a specific person in Gmail?
Use from:name@email.com in the search bar. You can use a full email address or just a name — from:sarah will find all emails from anyone named Sarah or with "sarah" in their address.
How do I search Gmail by date range?
Use after:YYYY/MM/DD and before:YYYY/MM/DD. For example: after:2026/01/01 before:2026/03/31 finds all emails from Q1 2026. For relative dates, use newer_than:7d or older_than:3m.
Can I search for emails with attachments in Gmail?
Yes. has:attachment finds any email with an attachment. filename:pdf narrows it to PDFs. filename:xlsx finds spreadsheets. You can also filter by size: has:attachment larger:5M.
How do I combine multiple search operators in Gmail?
Type them separated by spaces — Gmail treats spaces as AND. Use OR (uppercase) for either/or, and - (minus) to exclude. Parentheses group terms: from:boss (subject:urgent OR subject:critical).
Why doesn't Gmail search find my old emails?
The most common cause: the email is in Trash or Spam, which Gmail excludes by default. Add in:anywhere to search everywhere. Also check if you're accidentally searching within a specific label. If you regularly search a large archive, a desktop client like ChainMail can be faster — it searches your locally synced mail without server round-trips.