Skip to content

Notes and the tree

Any entry can sit inside one other entry, its Parent. This lets you put notes inside notes, like in Notion.

Notes

Plain notes (a title and some writing) live in the Notes collection, so New note works at once.

  • One entry of Notes is called a “note”, so the buttons say New note and the toasts say “Note moved to Trash · deleted for good after 30 days”. See What one entry is called.
  • Notes is a normal collection. It has a Title, one Block page property and a Children property, so notes nest inside notes.
  • The app makes it the first time you start it. You can rename it, change it or delete it. A deleted collection goes to the Trash for 30 days, with Undo. If your notes home is gone, the next New note quietly makes a new Notes. See What you start with.
  • Any other entry can be a parent too: a project can hold its tasks, a workout can hold its sets.

There are no sidebar folders. To group things, make a note (“Health”) and put things inside it. The group is a real note.

“Page” means a screen

  • The entry page is the screen of one entry.
  • The collection page is the screen of one collection, with its views.
  • The hub page is the screen of one hub, with its tabs.

“Page” is never a kind of thing you make. You make notes and other entries, and each one has its entry page.

The tree and the breadcrumb

In the sidebar, the starred note Health opens with its arrow: it holds the note Running plan, which holds the workout Morning run. Under Collections, Notes and Workouts are single buttons with no arrow. The breadcrumb on Morning run’s entry page starts with its collection, Workouts, then follows that chain. Morning run still lives in Workouts.Sidebar · Favorites▾ Health (a note)▾ Running plan (a note)Morning run (a workout)Sidebar · CollectionsNotesWorkoutsheader row of Morning run’s entry pageWorkouts / Health / Running plan / Morning runthe first crumb is its collectionWorkouts (its collection)Morning run · Push day · …it still shows here, always
The Parent chain builds the tree under an entry’s row and the breadcrumb. The collection never changes.
  • An entry’s row has an arrow wherever it shows in the sidebar: in Favorites, in a hub, or as a view’s pinned page. The arrow shows the entries inside it, from any collection, and each of those has its own arrow, at every depth, as in Notion. Morning run is a workout, but it shows under Running plan, because its Parent is a note. A row with nothing inside has no arrow.
  • A collection’s row is one button. It opens the collection page. It has no arrow and never lists its entries.
  • Point at an entry’s row to see its + and its ••• menu. The + makes a new note inside that entry, and it shows under the row at once.
  • There is no separate tree part in the sidebar. The sidebar has five sections: Views, Hubs, Chats, Favorites and Collections. See Hubs and tabs.
  • The breadcrumb in the page’s header row starts with the entry’s collection, then follows the Parent chain: 🏋️ Workouts / Health / Running plan / Morning run. An entry with no parent shows its collection and its own title. See Find your way around.

Rules

  1. One Parent at most. One parent keeps the breadcrumb, the tree, delete and the file clear. To show an entry in a second place, use a link, a live View block or Favorites.
  2. A Parent never hides anything. Morning run shows inside Running plan and in Workouts.
  3. No loops. A note cannot sit inside its own child. The app refuses the move.
  4. Collections never have a parent. An entry shows a collection only as a link or as a live View block.

What shows inside an entry

An entry page lists the entries inside it only when its collection has a Children property. The person who designs the collection decides how the children show. The Notes collection has a Children property, so the notes inside a note always show.

Type /note (or /page) in a Block page to make a New note inside this entry. The new note gets this entry as its Parent, its link appears where you typed, and it opens in the same tab. Back returns you here. See Block pages and dashboards.

Set, move and remove a Parent

You want to… Do this What changes
Put a new entry inside a note Create it from the note’s entry page, type /note in it, or press + on its row in the sidebar Its Parent is set to that note
Move a note Drag it onto another note in the sidebar tree, or use Move to… Only its Parent changes
Set a parent by hand Pick one in the entry’s Parent field Only its Parent changes
Take it out Clear the Parent field It moves to the top level

In your folder, the Parent is one line in the child’s file: parent: [[Notes/Running plan]]. Edit that line in any editor and the entry moves in the app.

Duplicate an entry

On an entry’s page, ••• → Duplicate makes a copy beside it and opens the copy, as in Notion. The copy has every value, every Block page and dashboard, and a copy of each sub-entry at every depth (sub-entries in the Trash are left out). Its title ends in “ (1)“. Tags, relations and files point at the same things as before. Example: duplicate “Kettlebell day” and you get “Kettlebell day (1)” with its exercises, sets and notes. It is one change: the toast’s Undo (or Ctrl+Z) takes the whole copy back.

When a parent is deleted

Deleting a parent moves everything inside it, at every depth, to the Trash with it, in one change. The toast has Undo, and restoring the parent from the Trash brings them all back. If a child’s parent is gone for good, the child moves to the top level. It is never lost.