Search
Every folder's list, All notes among them, and the Todos page share one search bar and one query language. This page shows how a query is read, how to build one with Advanced, and every filter there is.
Where you search
A search bar heads every folder's list and shows the folder it searches. With nothing typed, the list is the folder's notes. Type a query and the list becomes the notes in that folder that match, each card with the lines that matched.
All notes, the first row of the folder tree, is the same list over every note you can see, and Go to Search in the command palette opens it with the keyboard in its search bar. What you type goes into the page's address, so you can link to a search, reload it, or come back to it. The Todos page has the same bar for todos, and the Uploads page has it for files. Your agents and the ink CLI read the same language.
As you type a filter's name or value, the bar offers completions. Tab takes the first, the arrow keys move, and Enter takes the one you moved to. Folders, tags, and people are offered from what you can already see.
How a query is read
- A word matches a note that has that word, or a word that starts with it, ignoring case and accents.
"second quarter"matches the words together, in that order.- A space between terms means AND.
ORmeans either.AND,OR, andNOTare operators only in capitals, sooris a word. -before a word, a phrase, a filter, or a group excludes it.NOTdoes the same.- Parentheses group terms, up to 8 deep.
NOTbinds first, then AND, then OR. key:valueis a filter. Put a value with a space in quotes, as infolder:"Common Ink".- Dates and numbers compare with
>,>=,<,<=, and ranges witha..b.*leaves one side of a range open. - A day is
YYYY-MM-DD, or a day counted from today, such astoday,yesterday,tomorrow,7dfor seven days ago, and+7dfor seven days ahead. #moneyis short fortag:money, andno:tagis short for-has:tag.
A query has at most 40 terms and 200 characters.
A search covers live notes. Archived notes are included only when the query says is:archived, and Trash only when it says is:trashed. So is:archived alone lists archived notes, and budget (is:open OR is:archived) searches both.
Notes whose title matches come first, then the most recently changed. A sort: filter changes the order, and in:title looks for the words in titles only.
If the bar can't read a query, it says why under the field and marks the part that is wrong. A misspelt filter is an error, not a search. For foldr:Projects, the bar asks whether you meant folder:. A word is still read as words when a digit or a symbol comes before its colon, or when nothing or a / follows it, as in 10:30, re:, and https://example.com.
Build a query with Advanced
Press Advanced beside the bar to open the builder. Each condition is a row with a field, is or is not, a comparison where the field has one, and a value. Add a condition adds a row. Match all or Match any joins the rows. Words in and Sort set where words are looked for and the order.
Each change is written into the bar, and what you type in the bar is read back into the rows. A query the rows can't show, such as one with a group inside it, stays as you typed it.
Press ? in the builder to open the query syntax help. Every example in it is a button that runs the query.
List a search in a note
Write /search( and a query ) in a note, or pick Search results from the / menu, and the note lists the notes the query finds. The list keeps itself up to date: a note that starts to match joins it a moment later, with no reload.
/search(created:today)
/search(tag:work updated:>=7d limit=5)
- The words between the parentheses are the query, exactly as a search bar takes it.
limit=5after the query sets how many notes are listed, from 1 to 50. Without it the list shows 10, and a line under it links to the rest. - Each row shows a note's title, its folder, and when it was edited. Click a row to open the note. The query in the list's head opens All notes searched for it.
- The list is searched as whoever is reading the note. Each reader sees only the notes they can see, and
todayor7dcounts from their own day. A date written out, such ascreated:2026-11-10, stays that day. - The note the list is in is left out of it. Search doesn't find a note by a list's query either: a note with
/search(zebra)in it isn't found by searching for zebra. - A tag in the query,
#workortag:work, narrows the list and doesn't tag the note the list is in. - The settings button in the list's head has the query and the limit. The query is set with the same search bar a folder's page has: it offers filters and their values as you type, Advanced builds a query from conditions, and the list follows what you type. A query the bar can't read is left out of the note until it can.
On a page opened from a share link the list shows no notes, because nobody there is a member.
A new daily note starts with one of these: /search(created:2026-11-10), with the note's own date, lists the notes made that day.
Examples
| To find | Type |
|---|---|
| Notes you changed this week that still have an open todo | editor:@me updated:>=7d has:open-todo |
| A phrase in one folder and the folders inside it | folder:Projects "launch plan" |
Notes tagged money but not taxes |
#money -#taxes |
| Notes with either word in the title | (budget OR forecast) in:title |
| Archived notes about the budget | budget is:archived |
| Notes made in October that have no tags | created:2026-10-01..2026-10-31 no:tag |
| Notes that mention a person | mentions:"Grace Hopper" |
| Notes that show a file, oldest change first | has:attachment sort:updated-asc |
| Todos assigned to you and overdue, on the Todos page | assignee:@me due:<today |
| Large files no note uses, on the Uploads page | used:no size:>10mb |
@me stands for you in editor:, author:, mentions:, assignee:, and uploader:.
folder:, editor:, author:, and uploader: must name something you can see. A name that matches nothing is refused with a message, so a typo doesn't look like an empty result.
Every filter
Notes
| Write | It finds | Example |
|---|---|---|
word |
Has the word, or one that starts with it, ignoring case and accents | budget |
"a phrase" |
Has the words together, in that order | "second quarter" |
a b |
Both: a space is AND, which can also be written | budget plan |
a OR b |
Either. OR, AND and NOT are operators only in capitals | budget OR plan |
-a, NOT a |
Not: before a word, a phrase, a filter or a group | budget -plan |
( ) |
Groups, up to 8 deep. NOT binds first, then AND, then OR | (budget OR plan) -draft |
key:>DAY, >=, <, <= |
After, on or after, before, on or before a day or a number | updated:>2026-10-01 |
key:A..B |
From A to B, both included. * leaves one side open | created:2026-10-01..* |
today, yesterday, tomorrow, 7d, +7d |
A day counted from today: 7d is seven days ago, +7d seven days ahead | updated:>=7d |
#NAME |
Short for tag:NAME | #money |
key:"a value" |
A value with a space in it is written in quotes | folder:"Common Ink" |
folder:NAME |
In a folder, named or by its id, or in a folder inside it | folder:Unsorted |
tag:NAME |
Tagged with it or a tag inside it, as #NAME/sub. #NAME is short for it. A note has every tag written in it. A todo has the ones on its line, a heading's over it, a line of tags' above it in its section, and a list item's it is nested in | tag:money |
updated:DAY |
The day the note was last changed | updated:>=2026-10-01 |
created:DAY |
The day the note was made | created:2026-10-01..2026-10-14 |
editor:NAME, edited-by:NAME |
Changed by a member or an agent, by name. @me is you | editor:@me |
author:NAME |
First written by a member or an agent, by name. @me is you | author:@me |
mentions:NAME, mention:NAME |
Mentions a person, by name or id. @me is you | mentions:"Grace Hopper" |
mentions-agent:NAME |
Mentions an agent or any subagent under it, by name or id | mentions-agent:"Grok Bot" |
is:open |
Not archived and not in Trash | is:open |
is:archived |
Archived. A query that doesn't say so leaves archived notes out | is:archived |
is:trashed |
In Trash. A query that doesn't say so leaves Trash out | is:trashed |
is:private |
In your own Private: only you, and whoever you let in, see it | is:private |
is:shared |
In a shared folder you are in: one for everyone, or one that names you | is:shared |
is:everyone |
In a shared folder for everyone in the workspace | is:everyone |
is:named |
In a shared folder that names the people in it | is:named |
is:withme |
Shared with you: someone let you in to it, or to a folder it is in, from where you see nothing else | is:withme |
is:granted |
Shared by itself with a person or by a link, where you may see how it is shared | is:granted |
has:todo |
Has a todo, in any state | has:todo |
has:open-todo |
Has an open todo | has:open-todo |
has:link |
Links to another note | has:link |
has:backlink |
Linked to from a note you can see | has:backlink |
has:tag |
Has any tag | has:tag |
has:attachment |
Shows an upload: a picture, a video, sound or a file | has:attachment |
no:WORD |
Lacks it: the same as -has:WORD | no:todo |
in:title |
Every word of the query is looked for in the note's title | budget in:title |
in:body |
Every word is looked for in the note's text, or for a todo in its line | budget in:body |
sort:updated-desc |
Latest changed first | sort:updated-desc |
sort:updated-asc |
Longest unchanged first | sort:updated-asc |
sort:created-desc |
Newest first | sort:created-desc |
sort:created-asc |
Oldest first | sort:created-asc |
sort:title-asc |
By the note's title, A to Z | sort:title-asc |
sort:title-desc |
By the note's title, Z to A | sort:title-desc |
Todos
| Write | It finds | Example |
|---|---|---|
word |
Has the word, or one that starts with it, ignoring case and accents | budget |
"a phrase" |
Has the words together, in that order | "second quarter" |
a b |
Both: a space is AND, which can also be written | budget plan |
a OR b |
Either. OR, AND and NOT are operators only in capitals | budget OR plan |
-a, NOT a |
Not: before a word, a phrase, a filter or a group | budget -plan |
( ) |
Groups, up to 8 deep. NOT binds first, then AND, then OR | (budget OR plan) -draft |
key:>DAY, >=, <, <= |
After, on or after, before, on or before a day or a number | updated:>2026-10-01 |
key:A..B |
From A to B, both included. * leaves one side open | created:2026-10-01..* |
today, yesterday, tomorrow, 7d, +7d |
A day counted from today: 7d is seven days ago, +7d seven days ahead | updated:>=7d |
#NAME |
Short for tag:NAME | #money |
key:"a value" |
A value with a space in it is written in quotes | folder:"Common Ink" |
folder:NAME |
In a folder, named or by its id, or in a folder inside it | folder:Unsorted |
tag:NAME |
Tagged with it or a tag inside it, as #NAME/sub. #NAME is short for it. A note has every tag written in it. A todo has the ones on its line, a heading's over it, a line of tags' above it in its section, and a list item's it is nested in | tag:money |
updated:DAY |
The day the note was last changed | updated:>=2026-10-01 |
created:DAY |
The day the note was made | created:2026-10-01..2026-10-14 |
editor:NAME, edited-by:NAME |
Changed by a member or an agent, by name. @me is you | editor:@me |
author:NAME |
First written by a member or an agent, by name. @me is you | author:@me |
assignee:NAME, assigned:NAME |
Assigned to a person: mentioned on the todo's line, by name or id. @me is you | assignee:@me |
assignee-agent:NAME |
Assigned to an agent or any subagent under it, by name or id | assignee-agent:"Grok Bot" |
is:open |
A box written [ ]: open. A query that names no state lists only open todos | is:open |
is:done |
A box written [x]: done. With is:open OR is:done, both | is:done |
is:abandoned |
A box written [-]: abandoned, which won't be done | is:abandoned |
is:backlog |
A box written [>]: in the backlog, put off for some day | is:backlog |
is:archived |
In an archived note. A query that says neither this nor -is:archived follows the Todos in archived notes setting | is:archived |
is:trashed |
In Trash. A query that doesn't say so leaves Trash out | is:trashed |
is:private |
In your own Private: only you, and whoever you let in, see it | is:private |
is:shared |
In a shared folder you are in: one for everyone, or one that names you | is:shared |
is:everyone |
In a shared folder for everyone in the workspace | is:everyone |
is:named |
In a shared folder that names the people in it | is:named |
is:withme |
Shared with you: someone let you in to it, or to a folder it is in, from where you see nothing else | is:withme |
is:granted |
Shared by itself with a person or by a link, where you may see how it is shared | is:granted |
has:link |
Links to another note | has:link |
has:backlink |
Linked to from a note you can see | has:backlink |
has:tag |
Has any tag | has:tag |
has:due |
Has a due date | has:due |
has:repeat |
Repeats | has:repeat |
no:WORD |
Lacks it: the same as -has:WORD | no:link |
due:DAY |
The day a todo is due. Overdue is due:<today | due:<today |
priority:LEVEL, importance:LEVEL |
A todo's priority: high, medium, low or none, written !!!, !!, ! or nothing. 3 to 0 read the same | priority:>=medium |
in:title |
Every word of the query is looked for in the note's title | budget in:title |
in:body |
Every word is looked for in the note's text, or for a todo in its line | budget in:body |
sort:updated-desc |
Latest changed first | sort:updated-desc |
sort:updated-asc |
Longest unchanged first | sort:updated-asc |
sort:created-desc |
Newest first | sort:created-desc |
sort:created-asc |
Oldest first | sort:created-asc |
sort:title-asc |
By the note's title, A to Z | sort:title-asc |
sort:title-desc |
By the note's title, Z to A | sort:title-desc |
sort:due-asc |
Soonest due first, and those with no due date last | sort:due-asc |
sort:due-desc |
Latest due first, and those with no due date last | sort:due-desc |
sort:priority-desc |
Highest priority first | sort:priority-desc |
sort:text-asc |
By the todo's words, A to Z | sort:text-asc |
Uploads
| Write | It finds | Example |
|---|---|---|
word |
Its name has the word in it, ignoring case | report |
"a phrase" |
Its name has the words in that order | "q2 report" |
a b |
Both: a space is AND, which can also be written | report type:pdf |
a OR b |
Either. OR, AND and NOT are operators only in capitals | type:image OR type:video |
-a, NOT a |
Not: before a word, a phrase, a filter or a group | -type:image |
( ) |
Groups, up to 8 deep. NOT binds first, then AND, then OR | (type:pdf OR type:text) used:no |
key:>VALUE, >=, <, <= |
After, on or after, before, on or before a day; larger, at least, smaller, at most a size | size:>=500kb |
key:A..B |
From A to B, both included. * leaves one side open | size:1mb..5mb |
today, yesterday, tomorrow, 7d, +7d |
A day counted from today: 7d is seven days ago, +7d seven days ahead | uploaded:>=7d |
key:"a value" |
A value with a space in it is written in quotes | name:"Q2 report" |
name:TEXT |
The name has this in it, ignoring case | name:report |
type:image |
A picture | type:image |
type:video |
A video | type:video |
type:audio |
Sound | type:audio |
type:pdf |
A PDF | type:pdf |
type:text |
Text to read, by its name's ending: txt, md, markdown, csv, tsv, json, log, yaml, yml, toml, xml, html, css, js, ts, py, sh, sql | type:text |
type:other |
Any other file | type:other |
uploader:NAME, uploaded-by:NAME |
Uploaded by a member or an agent, by name. @me is you | uploader:@me |
used:yes |
A note you can see shows it | used:yes |
used:no |
No note you can see shows it | used:no |
size:SIZE |
How big the file is: bytes, or kb, mb or gb | size:>1mb |
uploaded:DAY |
The day the file was uploaded | uploaded:>=2026-10-01 |
is:open |
Not archived and not in Trash | is:open |
is:archived |
Archived. A query that doesn't say so leaves archived uploads out | is:archived |
is:trashed |
In Trash. A query that doesn't say so leaves Trash out | is:trashed |
is:private |
You uploaded it, and no note shows it but in your own Private | is:private |
is:shared |
A note in a shared folder you are in shows it: one for everyone, or one that names you | is:shared |
is:everyone |
A note in a shared folder for everyone in the workspace shows it | is:everyone |
is:named |
A note in a shared folder that names the people in it shows it | is:named |
is:withme |
Shared with you: you didn't upload it, and see it by no note in a shared folder of yours or your Private | is:withme |
is:granted |
Shared by itself with a person or by a link, where you may see how it is shared | is:granted |
sort:uploaded-desc |
Latest uploaded first | sort:uploaded-desc |
sort:uploaded-asc |
Earliest uploaded first | sort:uploaded-asc |
sort:name-asc |
By the file's name, A to Z | sort:name-asc |
sort:size-desc |
Largest first | sort:size-desc |