Note properties

A review date, a status, where something came from — as fields on the note rather than words encoded into its title. Everything here is optional, and a note that answers none of them is a perfectly ordinary note.

What they are for

Some things about a note are facts rather than writing. "Review this in March" is a fact; "Lease review 2026-03-14" is a title somebody had to remember to spell the same way as everybody else. A property gives that fact a place to live, the same place every time, where it can be searched for exactly.

Start with a subject, not a property. If what you want is "everything about the ferry terminal", write [[ferry terminal]] in the notes and follow the link — that already works and needs nothing set up. A property earns its keep when you need exactly one value per note (a status is one thing at a time, where a note can mention two subjects in a sentence), or a date you can compare (searching by date otherwise only reaches when the file was written, not when the work is due).

Defining them

Under Settings → Properties, and only an administrator can: a property is a vocabulary everybody in the workspace then writes in. Five kinds:

KindHolds
Textanything — a URL, a reference, a name
Datea day, written 2026-03-14
Numbera quantity. 1,234.56 and 1.234,56 are the same number, whichever way you write it
Checkboxyes or no
One of a listexactly one of the choices you set

The kind cannot change afterwards. A date that became text would be a column of dates nobody can compare. Make another property and move the values across.

Renaming is safe

Rename a property whenever you like. Every search written against its old name goes on working — including a saved view, which is the one search nobody re-types and so the one that would otherwise go quietly empty. The name on the page and the name a search uses are allowed to differ, and both find the same thing.

Taking a choice off the list

A choice can stop being offered without being deleted. Notes already holding it keep saying it, marked as no longer offered, and stay findable by it — because a note that said "In review" last March really did say that. The page tells you how many notes hold a choice before you take it off the list.

Answering them

On a note's Settings page — the gear, or s — whatever kind of note it is. A property belongs to the note rather than to what is inside it, so a board can have a review date just as a Markdown note can.

Anybody who can write in a note can answer its properties. Anybody who can read it sees the answers. Clearing a field removes the answer rather than storing an empty one — a note that says nothing about a property has not answered it, which is not the same as answering it with nothing.

Finding things by them

In the search box, with prop::

What you typeWhat it finds
prop:status=donenotes whose Status is exactly Done
prop:"status=in review" quote the whole clause when the value has a space in it
prop:review-date<=2026-06-30 everything due for review by the end of June
prop:review-date>=2026-01-01on or after that day
prop:review-datenotes that answer it at all
lease prop:status=done and it combines with an ordinary search for words

The name after prop: is the one shown beside each property on the settings page. A property nobody has defined says so rather than returning an empty page that looks like an answer. Ranges (>=, <=) are for dates and numbers, which are the kinds that have an order.

Templates

A template can fill properties in when a note is made from it — "every review starts as In review". They are defaults: anybody can change them afterwards, and changing the template does not go back and change the notes it has already made.

Programs, and Claude

A note's properties come back with the note through the API and through Claude, keyed by the name a search uses rather than by the display name — so a program keeps working when somebody renames one. Setting them is writing in a note and asks for the same permission. Defining a property is not something a key can do.

Export and import

The definitions travel with the values, because a value with no question is a number with nothing to be a number of. If you import a workspace whose "Status" is not your "Status", the two are kept apart rather than merged — the arriving one comes in under a name of its own, and your notes are left under your own vocabulary.

What is not built