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.

Quick example: To find all PDFs that Sarah sent you in January 2026, type:

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
Tip: You don't need the full email address. 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)
Relative time units: 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)
Storage cleanup tip: Search 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:budget means 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, or in: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:

  1. Run your search in Gmail
  2. Click the filter icon (right side of search bar) or the Show search options dropdown
  3. Click Create filter at the bottom
  4. 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 Free

Frequently 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.