Tags and Search

Folders give your project physical structure, but tags let you layer meaning on top of it. A document can live in one folder but belong to multiple categories — "Draft," "Chapter," "Needs Review" — all at the same time. Combined with Atlas's search, tags make it easy to slice through a large project and find exactly what you need.

Creating Tags

Tags are managed per project. Each tag has three properties you can customize:

Name — A descriptive label (e.g., "Draft," "Character," "Primary Source")
Color — A custom color that appears alongside the tag throughout the app
Icon — Chosen from a built-in catalog of over 500 icons across 15 categories, searchable by name and keyword

To create a tag in the Inspector:

On iOS: Open the Inspector's overview panel, go to the Tags section, and tap the + button. In the tag picker, you can tap "Create" where you can edit a tag's name, color, and icon at any time.
On macOS: Open the Inspector's overview panel and tap the "+" button. You can type a tag's name directly in the search bar to either select an existing or create a new one.

Tags can be created, edited, and deleted in the Project Settings.

Hierarchical Tags

Tags support parent-child relationships with unlimited nesting, which is useful when you need categories at different levels of specificity. For example, you might create a "Status" parent tag with "Draft," "Revised," and "Final" as children — or a "Characters" tag with "Protagonist," "Antagonist," and "Supporting" nested beneath it. Searching for a parent tag will also include any children tags as well.

Hierarchical tags let you filter broadly (by parent) or precisely (by a specific child), depending on what you're looking for.

Assigning Tags to Documents

Assign tags from the Inspector > Overview > Tags section while viewing any document. A document can have as many tags as you need — they're not mutually exclusive.

Tags also carry over from templates: when you create a new document from a template, any tags on that template are automatically assigned to the new document. This is handy for ensuring that, say, every new character profile starts with a "Character" tag without you having to remember.

Where Tags Show Up

Once assigned, tags appear in several places:

The Inspector — alongside the document's other metadata
The Folder Outline View — toggle tag visibility to see tags beneath each document title, giving you a quick sense of what's what as you scan a folder
Search results — tags are searchable and can be used as query token filters (see below)

Searching Your Project

The Search Field

The search field sits at the top of the Organizer sidebar. Start typing and results appear instantly — Atlas searches across document titles, body content, synopses, and notes all at once.

When the search field is empty, Atlas shows your most recently edited documents for quick access.

Query Tokens

For more targeted searches, add query tokens to narrow results beyond plain text:

Token	What it does
Text scope	Limit the search to all content or titles only
Has synopsis	Show only documents that have a synopsis filled in
Has notes	Show only documents that have notes
By tag	Filter to documents with one or more specific tags

Tokens of different types combine with AND logic — so filtering by a tag and "has synopsis" returns only documents that match both. Multiple tokens of the same type combine with OR logic — filtering by two tags returns documents with either tag.

Tip

Query tokens and text search work together. You can type a search term and add a tag filter to find, say, every document tagged "Character" that mentions "the forest."

Spotlight Integration

Atlas indexes your documents for system-wide Spotlight search, so you can find your writing without even opening the app. Indexed content includes document titles, body text, synopses, notes, and tags. Results display the document's icon and project name for context.

Use Cmd+Space on Mac or pull down on the Home Screen on iPad/iPhone to search for Atlas documents from anywhere on your device.