How-to · Gmail for Mac

How to use search operators in Gmail on Mac: gmail search operators mac, step by step

To use search operators in Gmail on Mac, open Gmail in Safari or Chrome, click the search bar, and type an operator such as from:, to:, or has:attachment. Press Return, then use the filter chips or Show search options to narrow the results.

Updated Checked against Gmail web app in Safari or Chrome on macOS, including the search bar and advanced search dialog8 minEasy

Person at a Mac using gmail search operators mac to find one message in a crowded inbox
A long inbox is where search operators earn their keep. · Image by Mohamed_hassan from Pixabay

Quick answer

  • Gmail on Mac means the web app in Safari or Chrome. There is no native Mac app to install.
  • An operator is a keyword and a colon, such as from:, to:, subject:, or has:attachment.
  • Stack operators with spaces, use OR for either-or matches, and use a minus sign to exclude a term.
  • Set the Search dropdown to Mail & Spam & Trash, or Spam and Trash stay out of your results.
  • Press / to jump into search after you turn on keyboard shortcuts in Gmail settings.

What you need

  • A Gmail account you can sign in to
  • Safari or Chrome on macOS
  • Permission to change Gmail settings, if you want keyboard shortcuts
  • A few minutes to test each operator on a real search

How to Use Gmail search operators on a Mac in Gmail on a Mac

  1. Open Gmail in Safari or Chrome

    Open Safari or Chrome and sign in to Gmail. On a Mac, Gmail runs in the browser because Google does not offer a native Mac app. Use the account that holds the mail you want to search.

    Tip: If you use several accounts, check the account name in the top right corner before you search.

  2. Turn on keyboard shortcuts

    Settings (gear icon)See all settings

    Click the gear icon, then See all settings. Find the keyboard shortcuts section, select the option to turn them on, and click Save Changes. Shortcuts will not work until you save this change.

    Tip: Google's help says the Settings tab. Some guides say General. Look for the Keyboard shortcuts row in whichever tab you see.

  3. Click the search bar

    /

    Click the search bar at the top of the inbox. Or, with shortcuts on, press / and the cursor moves into the search box. Type your query and press Return.

    Tip: Use / when your hands are already on the keyboard. It saves a trip to the mouse.

  4. Type your first operator

    Type the operator name, a colon, and the value with no space. For example, type from:priya to find mail from a sender whose name or address includes priya. Press Return to see the results.

    Tip: Test one operator first. Add more only after the first one returns what you expect.

  5. Stack operators with spaces

    Put a space between operators to combine them. The query from:priya has:attachment filename:pdf finds PDF files sent by Priya. Each extra operator narrows the results.

    Tip: Google lists AND as an operator, but a plain space already combines the terms for you.

  6. Use OR for either-or matches

    Type OR between two terms to match either one. For example, from:priya OR from:tom finds mail from either person. Wrap the choice in parentheses when you add more terms, like (from:priya OR from:tom) subject:launch.

    Tip: Google's examples write OR in capital letters, so copy that style exactly.

  7. Exclude a word with a minus sign

    Put a minus sign directly before a word or operator to leave it out. For example, -newsletter removes results that contain that word. Negative results are not always clean, so read what appears.

    Tip: Google warns that conversations with excluded criteria may still appear, so check before you delete.

  8. Open Show search options

    Search barShow search options

    Click Show search options at the right end of the search bar. The advanced dialog opens with fields for From, To, Subject, Has the words, Doesn't have, Size, and Date within.

    Tip: Use the dialog when you remember details but not the exact operators.

  9. Include Spam and Trash in the search

    Show search optionsSearch dropdownMail & Spam & Trash

    Open the Search dropdown in the dialog and choose Mail & Spam & Trash. Without this choice, normal search leaves out Spam and Trash. Google's missing mail page uses the same setting when you look for lost messages.

    Tip: Keep this choice only while you look for lost mail, because results get longer.

  10. Fill the fields and click Search

    Fill in the boxes that match what you remember, such as sender, subject words, or date. Then click Search at the bottom of the dialog to run the query.

    Tip: Fill fewer boxes first. A shorter query shows more results, so you can narrow down from there.

  11. Read the filter chips after Return

    Press Return in the search bar and filter chips appear under the box. Google lists From, To, Any time, Has attachment, Exclude calendar updates, Is unread, and Is encrypted. Click one to narrow results without typing.

    Tip: The chips show which common filters Gmail offers, so they help you learn the matching operators.

  12. Turn the search into a filter

    Show search optionsCreate filter

    Run the search from the dialog by clicking Search. Then click Create filter. Gmail opens the filter options, where you choose what happens to matching mail, such as applying a label.

    Tip: Review the matching results before you create the filter. A filter that matches too much can hide mail.

  13. Install Gmail as a Chrome app (optional)

    More (three dots)Cast, save, and shareInstall page as app

    In Chrome, with Gmail open, open the More menu and choose Cast, save, and share. Then choose Install page as app. Some sites show an Install icon at the right end of the address bar instead.

    Tip: The menu label may end with an ellipsis in your version of Chrome. Choose the item with that name.

Gmail has no native Mac app. When people search for Gmail on a Mac, they mean the Gmail web app in a browser. This guide assumes you use Safari or Chrome. Google's help pages describe the search steps without splitting them by browser, so the steps below apply to either one.

Search operators are words you type into the search bar. Each one has a keyword, a colon, and a value. Gmail reads the whole line and returns the messages that match its rules. You do not need a special mode. You type, then press Return.

Google documents the full list on its Refine searches page. The list is long. Most people use a handful of operators every week. The rest help when a search goes wrong and you need a tighter filter.

Think of the search bar as a short instruction. The query from:priya has:attachment asks for mail from Priya that carries a file. Gmail does the matching. You only have to write the instruction clearly.

Why good search saves real time at work

Searching for information eats into the workday. Microsoft's 2023 Work Trend Index surveyed 31,000 workers across 31 markets, fielded from February 1 to March 14, 2023. Of those workers, 62% said they struggle with too much time spent searching for information. That survey covers search in general, not Gmail, so treat it as context.

62%

of surveyed workers say they struggle with too much time spent searching for information at work

Microsoft Work Trend Index: Will AI Fix Work?

8.8 hours

a week on email for the heaviest 25% of email users, per Microsoft's 2023 data

Microsoft Work Trend Index: Will AI Fix Work?

15 GB

free storage shared across Gmail, Google Drive, and Google Photos

Google Account storage | Google Drive Help

30 days

before Gmail permanently deletes mail in Trash or Spam, unless you empty those folders sooner

Gmail messages are missing | Computer | Gmail Help

Email takes its own share of time. Microsoft also reports that the top 25% of heavy email users spend 8.8 hours a week on email. That figure comes from Exchange Online usage data for the 28 days ending March 2023. A precise query will not cut that time to zero. It does help you find one message without scrolling through pages of results.

The search operators you will use most

Google groups its operators by what they find, such as people, words, dates, labels, status, and location. The table below pulls out the ones most people reach for first. Type each one exactly as shown, with the colon directly after the keyword.

Common Gmail search operators and what each one finds
OperatorWhat it findsExample
from:Mail sent by a person or addressfrom:priya
to:Mail sent to a person or addressto:team@example.com
cc: and bcc:Mail where someone was copiedcc:tom
subject:Words in the subject linesubject:invoice
has:Mail with a feature such as an attachmenthas:attachment
filename:Attachments with a matching file namefilename:pdf
label:Mail with a label you createdlabel:clients
is:Mail with a status, such as read or unreadis:unread
after: and before:Mail sent in a date rangeFormat from Google's Refine searches page
newer_than: and older_than:Mail within a period, or older than onenewer_than:7d
in:anywhereMail in every folder, including Spam and Trashin:anywhere refund

Two details trip people up. The first is quotes. Put a phrase in curly quotes, such as “project kickoff”, when the phrase has a space. The second is parentheses. They group choices, so (from:priya OR from:tom) has:attachment means either sender, and the attachment rule applies to both.

Some operators take a number or a unit. newer_than and older_than accept d, m, or y for days, months, or years, as in newer_than:7d. The size, larger, and smaller operators filter by file size. Check Google's Refine searches page for the exact units before you rely on them.

Person at a Mac using gmail search operators mac to find one message in a crowded inbox
A long inbox is where search operators earn their keep. · Image by Mohamed_hassan from Pixabay

Worked examples you can copy

Real searches teach faster than rules. Copy these into the search bar, then swap in your own names and words. Each one solves a problem people hit often.

  • Invoices from one vendor, PDF only, from the last three months: from:billing@example.com has:attachment filename:pdf newer_than:3m
  • A renewal thread that skips newsletters: “contract renewal” -newsletter. Read the negative search section below before you act on the results.
  • Mail from either of two people about one project: (from:priya OR from:tom) subject:launch
  • Unread client mail older than a week: is:unread label:clients older_than:7d
  • Anything about a refund, including Spam and Trash: in:anywhere refund

Start with one operator and check the results. Add the next one only after the first returns what you expect. That habit saves you from building a long query and then wondering why nothing matches.

Build a search one step at a time

Say you need the signed contract that Tom sent earlier this year. You remember his name and the word contract. Start with from:tom and read the list. If the list is still long, add has:attachment. If it is still long, add subject:contract.

Stop when the results look right. Each extra operator narrows the list, and it can also push out the message you want. A search that is one term too strict returns nothing, and then you have to work backward.

When a search returns nothing, remove the newest operator first. The mistake is almost always in the last term you added, not in the ones that worked before.

Turn on keyboard shortcuts first

Press / to jump into the search bar. That shortcut works only after you turn on Gmail keyboard shortcuts. Google's help says shortcuts will not work until you do, and they are not supported by every language or keyboard.

Most Gmail shortcuts use ⌘ on a Mac, where Windows uses Ctrl. Google's page lists one Mac-only shortcut, ⌘ ;, for the next misspelled word. The page does not document Option (⌥) or Control (⌃) combinations for Gmail, so do not depend on those keys.

Shortcuts pay off when your hands already rest on the keyboard. Press /, type the query, press Return, and read the results. If the / key does nothing, check the setting first, then check your keyboard layout.

Gmail advanced search on Mac: Show search options and filter chips

Press Return after you type, and filter chips appear under the search bar. Google lists From, To, Any time, Has attachment, Exclude calendar updates, Is unread, and Is encrypted. Click a chip to add that rule without typing it. Chips are a good way to learn which operators match which rule.

For a more detailed search, click Show search options. The dialog has fields for From, To, Subject, Has the words, Doesn't have, Size, and Date within, plus a Search dropdown. Fill in what you remember, then click Search at the bottom.

Use the dialog when you remember a name or a date but not the operator. Fill one box first, check the results, then add the next box. It is the same method as typing operators, with fewer typos.

Turn a repeat search into a filter

A search you run every week deserves a filter. Build the search in Show search options, click Search, then click Create filter. Gmail turns the rules into a filter you can review and edit. Check the results first, because a filter that matches too much can hide mail.

Filters can also delete mail or skip the inbox. To review what already exists, open Settings > See all settings > Filters and Blocked Addresses. Google's help points there first when mail seems to vanish. For the full walk through, see creating a filter in Gmail on Mac.

Man using a MacBook to type a gmail search operators mac query for an old invoice
Narrow the search with a sender and a file type. · Image by StockSnap from Pixabay

Gmail negative search: exclude words without losing mail

A minus sign removes a term from results. A search for -newsletter hides mail that contains that word. The idea is simple. The behavior can surprise you.

Google warns that when you use negative search operators, conversations with excluded criteria may still appear. The reason is that Gmail identifies matching messages first. A conversation can therefore show up even when part of it contains the word you excluded.

Treat every negative search as a first pass. Open the results, read the subjects, and only then archive, label, or delete. A safer habit pairs the exclusion with a positive operator, such as from:tom -newsletter, so the list stays small.

Gmail search spam and trash on Mac

Normal search leaves out Spam and Trash. That is the most common reason a known message does not appear. To include both folders, open Show search options, open the Search dropdown, and choose Mail & Spam & Trash. Then fill in what you remember and click Search.

Google also says mail in Trash or Spam is permanently deleted after 30 days, or sooner when you empty those folders. A message you threw out last month may still be there. A message older than 30 days in those folders may already be gone.

The in:anywhere operator searches every folder when you type the query yourself. Google's Refine searches page lists it. Use it when you want one query to cover the whole account.

Why a search finds less than you expect

Most missing results come from a few causes. Check these in order before you assume the mail is gone.

  1. Spam and Trash are excluded from normal search. Set the Search dropdown to Mail & Spam & Trash to include them.
  2. Filters with Delete it or Skip Inbox can move mail out of sight. Check Filters and Blocked Addresses in settings.
  3. Forwarding can send a copy somewhere else. Check Forwarding and POP/IMAP in settings.
  4. Negative operators can still show conversations that contain the excluded term. Read each result before you act.
  5. Full storage can interrupt Gmail. Free accounts share 15 GB across Gmail, Drive, and Photos.

Location matters. Spam and Trash stay out of normal results. A message can also sit in the archive or in snoozed mail. Google lists in:archive and in:snoozed for those places, so add them when a message seems to have gone quiet.

Date operators follow Google's format. Use after and before with the date format shown on Google's Refine searches page, and use newer_than and older_than for rolling periods. A date typed in the wrong format may not match what you expect.

Office worker reviewing emails on a computer screen before a team meeting
Test one operator at a time before you trust a long query. · Image by kirill_makes_pics from Pixabay

Mistakes people make with search operators

  • Adding a space after the colon, as in from: priya, when Google's examples show the value right after the colon.
  • Forgetting that normal search skips Spam and Trash, then deciding the message never arrived.
  • Trusting a negative search without reading the results first.
  • Stacking five operators at once, then assuming the first one is broken.
  • Turning a broad search into a filter before testing it on real mail.

Search before you move anything. Find the message, confirm it is the right one, and only then decide what to do with it. That order takes a few seconds and prevents most regret.

Install Gmail as an app window in Chrome

If you use Chrome, you can install Gmail as its own window. Open Gmail, open the More menu, choose Cast, save, and share, then choose Install page as app. On some sites an Install icon appears at the right end of the address bar instead.

Search operators should work the same inside the app window, because it runs the same Gmail web app. Chrome's Web Store help documents a Create shortcut route through More Tools, but only for Windows, Linux, and Chromebook. On a Mac, use the Install page as app route described above.

Where to go next

If your inbox is still crowded after a good search, read how to unsubscribe from emails in Gmail on Mac. To give repeat searches a short name, see how to create a label in Gmail on Mac. For shortcuts, see turning on keyboard shortcuts in Gmail on Mac.

Gmail shortcuts for this on Mac

Gmail keyboard shortcuts on Mac
To do thisPress
Jump into the search bar (after keyboard shortcuts are on)/
Next misspelled word (Mac only, per Google)⌘ ;

If it does not work

A search finds nothing for an email you know exists
Set the Search dropdown to Mail & Spam & Trash, then search again. Check the Spam and Trash folders too, because Google deletes mail there after 30 days.
Mail seems to disappear from the inbox
Check Settings > See all settings > Filters and Blocked Addresses for filters that use Delete it or Skip Inbox. Then check Forwarding and POP/IMAP for a forwarding rule.
A negative operator still shows results
Google says Gmail identifies matching messages first, so excluded terms can still appear. Read each result and add a more specific positive operator.
The / shortcut does nothing
Turn on keyboard shortcuts under Settings > See all settings, click Save Changes, then try again. Google says shortcuts are not supported by every language or keyboard.
Gmail behaves oddly or stops working
Check storage. Free accounts share 15 GB across Gmail, Drive, and Photos, and Google says going over the limit can interrupt Gmail.

Faster with Lazur

Do it faster: ask Lazur while you are in Gmail

Hold ⌥ ⌘ and say what you want. Lazur sees your Gmail window. Lazur draws a circle and a label around the button or menu you need.

  • 1

    Hold ⌥⌘ and talk

  • 2

    Lazur draws a circle and a label around the button or menu you need.

  • 3

    You stay in Gmail. Nothing to copy into a chat window.

Free for 3 days, then $18/month. Download for Mac

You say“Where is the Show search options link?”

Lazur · points at itLazur circles Show search options next to your Gmail search bar. You still click it yourself, then fill in the fields.

Gmail
SendAttachShow search optionsRight hereFormatSchedule

Questions people ask

Is there a native Gmail app for Mac?

Not from Google. Gmail on a Mac means the web app in Safari or Chrome. Chrome can install Gmail as its own window, and the search operators work the same way in either setup.

What is the Gmail search shortcut on Mac?

Press / after you turn on keyboard shortcuts in Settings > See all settings. Google's shortcut page lists / for Search mail, and that shortcut does not use a Mac modifier key.

Why does my search skip Spam and Trash?

Normal search excludes both folders. Open Show search options, set the Search dropdown to Mail & Spam & Trash, then click Search again to include them.

Do negative operators always hide the excluded mail?

No. Google warns that conversations with excluded criteria may still appear, because Gmail identifies matching messages first. Read each result before you act on it.

Can I save a search so I can reuse it?

Yes, as a filter. Run the search in Show search options, click Search, then click Create filter. Filters can label mail or skip the inbox, so review the matching results first.

Do Option or Control shortcuts work in Gmail on Mac?

Google's keyboard shortcut page does not list Option (⌥) or Control (⌃) combinations for Gmail. Use the shortcuts that page lists, and check it again if you need more.

How do I search for an exact phrase?

Put the phrase in quotation marks, such as a full sentence or a project name. Gmail returns messages that contain that exact phrase. You can combine it with operators such as from: or has:attachment.

Sources

  1. Refine searches in Gmail - Gmail Help · Google · checked 2026-11-07
  2. Search in Gmail - Gmail Help · Google · checked 2026-11-07
  3. Gmail keyboard shortcuts - Gmail Help · Google · checked 2026-11-07
  4. Gmail messages are missing - Computer - Gmail Help · Google · checked 2026-11-07
  5. Use web apps - Computer - Google Chrome Help · Google · checked 2026-11-07
  6. Add & open Chrome apps - Chrome Web Store Help · Google · checked 2026-11-07
  7. Google Account storage - Google Drive Help · Google · checked 2026-11-07
  8. Microsoft Work Trend Index: Will AI Fix Work? · Microsoft · checked 2026-11-07

Try Lazur free for 3 days

Hold a key and ask. Lazur sees your screen, points at the button and talks you through it, in any Mac app. No credit card.