Gmail Search Operators: The Complete Guide To Finding Any Email In Seconds

Written by Sandy Writtenhouse

Can’t find the emails you need when searching in Gmail? This guide describes Gmail search operators, how to search in Gmail with them, and common issues you may come across. You’ll also find a quick cheat sheet of commonly-used commands along with a full reference of all available operators.

What Are Gmail Search Operators?

You may have heard the term “search operators” in regard to Gmail. And to many, this can sound a little intimidating. But Gmail search operators are actually easy to use and can more minutely and accurately narrow down your search results.

A Gmail search command includes the operator followed by a variable. For example, to search emails in your Gmail Inbox, you’d use in:inbox or to find messages you haven’t read, you’d use is:unread.

There are other operators that allow you to pick the variable. For instance, you can locate emails with a particular Gmail label using label: and entering the label name after the colon. The command label:finance finds all messages with the Finance label.

One more type of operator you can use is a character. Those like hyphens, brackets, and quotation marks can be used as well. For example, to exclude something from your search like messages in your Inbox, you’d use -in:inbox or to find an exact phrase, you’d place it within quotes.

Search operators are ideal when you need to locate specific emails and the built-in search filters don’t provide the criteria you need.

How to Search in Gmail (The Basics)

Before we delve into using search commands, it’s good to know how to search in Gmail using the basics available to you and how these tie into search operators.

The Search Box

When looking for particular messages, you can enter terms into the Search field at the top. As you click inside the box or start typing, you’ll see suggestions drop-down. This makes it easy to select a recent search or spot the email you need. The Search box is also where you enter search operators.

The Search Options

Instead of entering a term into the Search field, you can open the Search Options window using the button on the far right of the box. You can then enter or select criteria for common searches like From or To a certain sender, specific words in the Subject, and within a timeframe from a particular Date.

Along with receiving your results after entering the criteria and clicking the Search button, you’ll notice that search operators are automatically populated in the Search box. So, even if you don’t type the search commands yourself, Gmail uses them behind the scenes to find what you enter in the Search Options interface.

Gmail Search Operators Cheat Sheet (Quick Reference)

If you’re ready to start using search operators in Gmail, you’ll need to know your options. Although Gmail offers over 50 search commands, there’s a smaller subject that you’ll find most useful.

Operator
What It Does Example
"exact phrase"
Find an exact phrase "project deadline"
OR
Match either term (must be uppercase) from:john OR from:jane
-
Exclude a term or operator -from:noreply@company.com
from:
Messages from a specific sender from:john@example.com
label:
Messages with a specific label label:work
category:
Messages in a Gmail category tab category:promotions
is:starred
Starred messages is:starred
is:important
Messages marked as important is:important
in:inbox
Messages in your inbox in:inbox
in:trash
Messages in the trash in:trash
in:sent
Messages in Sent Mail in:sent
in:anywhere
Search all mail including Spam & Trash in:anywhere
has:attachment
Messages with any attachment has:attachment
filename:
Attachment by name or extension filename:pdf
larger:
Messages larger than larger:10M
smaller:
Messages smaller than smaller:100K
after:
Messages after a date after:2024/01/01
before:
Messages before a date before:2024/12/31
older_than:
Messages older than a time period older_than:1y
newer_than:
Messages newer than a time period newer_than:3m

Gmail Advanced Search: Power Combinations

While you can easily use a single search operator to quickly find what you need, the real power is in combining Gmail search commands. Here are several common examples of Gmail advanced search using combinations.

📌 Note: When you combine two, three, or more search operators, be sure to separate each by a single space.

smaller:10M larger:100K: Search for emails within a size range. This combo finds messages smaller than 10 megabytes and larger than 100 kilobytes.

after:2024/01/01 before:2024/12/31: Search for emails within a date range. This combo finds messages received after January 1, 2024 and before December 31, 2024.

label:work older_than:1y: Search for emails containing a particular label older than a timeframe. This combo finds messages labeled Work that are older than one year.

has:attachment filename:pdf: Search for emails with an attachment of a certain file type. This combo finds messages with PDF files attached.

from:john@example.com is:important is:unread: Search for emails from a particular sender that are specifically marked. This combo finds messages from a sender that are both important and unread.

-in:inbox -in:sent -in:chat -in:drafts: Search for any archived emails. This combo eliminates messages in the Inbox, Sent, Chat, and Drafts displaying only archived emails.

-in:inbox -in:sent -in:chat -in:drafts has:nouserlabels: Search for archived emails without custom labels. This combo is an alternative to finding all archived messages (above).

Gmail Search Not Working? Common Fixes

If you try to use operators to look for emails and find Gmail search not working as expected, there are some possible reasons. Luckily, most are easy to correct.

Search Operator Typos or Wrong Syntax

When typing search operators in Gmail, the syntax you use is extremely important. If you have a typo, missing colon, wrong case (for the OR operator), or no spaces when using a combination, this can return zero results.

💡 Solution: Carefully double-check your search commands and correct any errors.

No Results From Trash or Spam

If you’re searching for emails in either the Trash or Spam folder with no luck, you must use the in:trash or in:spam operator. This is because, by default, Gmail doesn’t look in those folders when searching with operators or filters.

💡 Solution: Use the corresponding search operator for the Trash or Spam, or as an alternative, use in:anywhere to search all mailbox locations.

Gmail Indexing Delays

As you receive emails in Gmail, Google’s systems index those messages. This involves analyzing and organizing content to make it searchable and to support features like Gmail Categories.

While this is a normal process, there are times when an indexing delay can occur. This is often due to synchronization issues, especially for very recent messages, full storage, too many labels, or browser issues.

💡 Solution: Sign out and back in, clear your browser cache, try incognito mode, or reduce your used Gmail storage.

Mobile App Limitations

Although you can use Gmail search operators to find emails in the mobile app, there are some limitations. For instance, there is no Search Options box for simple searches, the wildcard character (*) may not function correctly, and sorting search results defaults to Most Relevant rather than Most Recent.

💡 Solution: Use the most common search operators, avoid complex combinations, and consider using the pre-made search filters at the top after tapping inside the Search box. If problems persist, close and reopen the app.

Bonus: Keep Your Gmail Organized with Clean Email

Gmail’s search operators are convenient for finding the messages you need without manual scanning. But the more cluttered your mailbox, the longer the searches can take and the bigger the risk of still not locating the right emails.

To clear that clutter ahead of time, consider an app like Clean Email. With it, you can clean, organize, and find messages with smart tools and features.

Automatically filters emails in Clean EmailAutomatically filters emails in Clean Email

Check out Clean Email as a robust complement to your Gmail workflow. It’s available on desktop and mobile for any IMAP service provider.

Complete Gmail Search Operators Reference (50+ Operators)

To wrap up, see the below reference table for a complete list of Gmail search operators with examples and notes on usage.

Operator
What It Does Example Notes / Limitations
from:
Messages from a specific sender from:john@example.com Exact email or name
to:
Messages sent to a specific recipient to:jane@example.com
cc:
Messages where someone is CC'd cc:team@company.com
bcc:
Messages where someone is BCC'd bcc:boss@company.com Only works for sent mail
subject:
Search only the subject line subject:meeting agenda Partial match works
"exact phrase"
Find an exact phrase "project deadline Friday" Use double quotes
OR
Match either term (must be uppercase) from:john OR from:jane Default is AND
-
Exclude a term or operator -from:noreply@company.com Place directly before term
( )
Group search terms together (from:john OR from:jane) subject:report Combine with OR
AROUND
Find words near each other budget AROUND 5 report Number = max words apart
label:
Messages with a specific label label:work Use label name exactly
has:userlabels
Messages with any user-created label has:userlabels Excludes system labels
has:nouserlabels
Messages with no user labels has:nouserlabels Find unlabeled mail
category:
Messages in a Gmail category tab category:promotions primary, social, promotions, updates, forums
is:starred
Starred messages is:starred
has:yellow-star
Messages with a specific star color has:yellow-star yellow-star, blue-info, red-bang, etc.
has:blue-info
Messages with blue info icon has:blue-info Star variant
is:important
Messages marked as important is:important Gmail priority inbox
is:read
Messages you have read is:read
is:unread
Messages you haven't read is:unread from:boss@company.com Combine for powerful filters
in:inbox
Messages in your inbox in:inbox
in:trash
Messages in the trash in:trash Must search trash explicitly
in:spam
Messages in the spam folder in:spam Must search spam explicitly
in:sent
Messages in Sent Mail in:sent Same as from:me for most uses
in:drafts
Messages saved as drafts in:drafts
in:anywhere
Search all mail including Spam & Trash in:anywhere invoice Overrides default scope
in:chats
Search Google Chat messages in:chats If Chat history is saved
in:snoozed
Snoozed messages in:snoozed Gmail snooze feature
has:attachment
Messages with any attachment has:attachment
has:drive
Messages with Google Drive links has:drive
has:document
Messages with Google Docs attached has:document
has:spreadsheet
Messages with Google Sheets attached has:spreadsheet
has:presentation
Messages with Google Slides attached has:presentation
has:youtube
Messages with YouTube links has:youtube
filename:
Attachment by name or extension filename:pdf filename:report.xlsx also works
size:
Messages larger than specified bytes size:5000000 5 MB = 5,000,000 bytes
larger:
Messages larger than (accepts shorthand) larger:10M K, M accepted
smaller:
Messages smaller than smaller:100K K, M accepted
after:
Messages after a date after:2024/01/01 Format: YYYY/MM/DD
before:
Messages before a date before:2024/12/31 Format: YYYY/MM/DD
older:
Messages older than a time period older:7d d=day, m=month, y=year
newer:
Messages newer than a time period newer:2d d=day, m=month, y=year
older_than:
Alternative syntax for older older_than:1y Same as older:
newer_than:
Alternative syntax for newer newer_than:3m Same as newer:
deliveredto:
Messages delivered to a specific address deliveredto:alias@gmail.com Useful for aliases
list:
Messages from a mailing list list:team@googlegroups.com Matches List-ID header
replyto:
Messages with a specific Reply-To address replyto:support@company.com
rfc822msgid:
Find by Message-ID header rfc822msgid:abc123@mail.gmail.com Exact match only
is:muted
Muted conversations is:muted Won't reappear when new replies arrive
from:me
Messages you sent from:me Shortcut for your own address
to:me
Messages addressed to you to:me Direct messages only
{}
Group for OR logic (alternative syntax) {from:john from:jane} Same as using OR between terms
Try Clean Email for Free
*****4.5based on 3,300 user reviews
Get Started
InboxClean Your Mailbox

Use tools like Cleaning Suggestions and Smart Folders to help you quickly clean out an overloaded inbox

Mute unwanted emailsUnsubscribe

Keep unwanted emails out of your inbox by unsubscribing—even from email lists that don’t have an unsubscribe link

Clean your emailsKeep it Clean

Automate repetitive tasks with Auto Clean rules to archive emails as they become old or to sort them into folders

Background
Use filters to find emails you want to clean.Arrow
Screener FeatureArrow
UnsubscribeArrow
Auto CleanArrow
Sender SettingsArrow