MainspringGuides › Spotlight operators
macOS Guide

Spotlight Search Operators on Mac: Find Anything Faster

Updated July 2026 · 2 min read

Typing a filename into Spotlight is amateur hour. The search box understands a whole query language — kind:pdf invoice date:this week finds the document you're picturing in one line, no scrolling through apps, emails, and websites that happen to share a word. The same tokens work in Finder's search field. Here's the vocabulary.

kind: — the filter you'll use daily

Press Cmd+Space and prefix any search with a type filter:

So report kind:pdf means "PDFs containing or named report" — no more wading past a website suggestion and a Pages doc to get there. File extensions work as a variant too: searching report .numbers in Finder often gets you the same narrowing.

date: — search in time

Spotlight indexes when things were created and modified, and plain-English windows work:

kind:image date:today is the fastest possible answer to "where did that screenshot just go?" — and author: narrows documents by who made them, e.g. kind:pdf author:priya for files whose metadata carries her name.

Boolean logic: AND, OR, NOT

Spotlight treats multiple words as an implicit AND, but you can be explicit — the operators must be in capitals:

Combine freely: kind:presentation "kickoff" NOT 2024 date:this month reads almost like the thought in your head.

The same tokens work in Finder

Press Cmd+F in any Finder window (or just type into a window's search field) and every operator above works there too — with two Finder-only advantages. First, the search scope bar lets you flip between "This Mac" and the current folder. Second, typing a token like kind:pdf pops up a suggestion menu ("Kinds: PDF Document"); click it and Finder converts your token into a structured filter row you can stack with the + button — file size, tags, and dozens of metadata fields live there. Build a search you'll reuse and click Save: it becomes a Smart Folder that stays permanently up to date.

If results ever look wrong or incomplete — files you know exist not appearing — the index itself may be stale; rebuilding it fixes more Spotlight weirdness than any other trick.

More hidden power, zero syntax

Spotlight rewards people who learn its hidden depth — and so does the rest of macOS. Mainspring turns 90+ buried settings into labelled, reversible toggles you don't have to memorize.

Try Mainspring free →

Signed & notarized by Apple · 1-day free trial · $29 once

Keep the index honest

Operators are only as good as the index behind them. If Spotlight misses files that definitely exist, see how to rebuild the Spotlight index — and if it's finding too much (build folders, backups), exclude those folders so your queries return signal, not noise.