Skip to content

Collections

A collection is a list of one kind of thing, such as Workouts, Books or Sleep. You decide what each collection holds by giving it properties.

Shape and data

  • A collection and its properties are the shape of your data. This shape is also called the schema: the plan of what each entry holds. Workouts has Distance (a Number) and Type (Tags).
  • The entries are the data. Each entry fills in one value for each property. “Morning run” has Distance 5.2 km and Type Run.

You design the shape. The entries follow it. See How your data is organized.

What a collection has

Part What it is Example (Workouts)
Name and icon How it shows in the sidebar. The name is unique. Workouts, with a running-shoe icon
Properties The fields every entry can fill: the shape. A new collection starts with one Block page property called “Page”; rename it, remove it or add more. Distance, Duration, Type, Felt
Entries Every workout you logged: the data. “Morning run, 5.2 km”
Views Ways to show the entries: table, calendar, feed and more. They are the tabs of its collection page. A calendar of all runs
Presets Starting values for new entries. “Easy run” fills Type: Run
Tags Tags on the collection itself, to group and find your collections. fitness, health
Entry names What one entry, and several, are called in buttons and messages. workout, workouts
How its entries show What one entry shows in a tab and in an Entry block, at first. in a tab: the whole entry page; in a block: its card

One collection per shape, never per flavor

Make a new collection only when the fields are different. When only the kind of thing changes, use a tag or a preset in the same collection.

Wrong: three collections Runs, Swims and Rides. Right: one Workouts collection with a Type tag that says Run, Swim or Ride.Not thisRunsSwimsRidessame fields, three places to lookThisWorkoutsType (a tag): Run · Swim · RidePresets: Easy run, Pool lapsone list, one chart for all of it
Runs, swims and rides have the same fields, so they are one collection.

A “Books” collection and a “Workouts” collection have different fields, so they are two collections. A run and a swim have the same fields, so they share Workouts.

Rules

  • Every entry is in exactly one collection, from the day you make it until you delete it.
  • A collection always shows all its entries. Only a filter you add, the Trash or Hidden removes one from a view. See A collection always shows all its entries.
  • Properties belong to their collection. There is no shared list of properties across collections. To see several collections together, use a global collection.
  • A collection never sits inside an entry. Collections have their own Collections section in the sidebar. An entry can show a collection as a link or as a live View block, in as many entries as you like.
  • On your computer, a collection is a folder: Collections/Workouts/, with one file per entry. See Your folder.

What one entry is called

Each collection has two settings: One entry is called and Several are called. The app uses these words wherever it talks about the collection’s entries.

Collection One entry is called Several are called The + button says
Workouts, made by you Workouts entry Workouts entries New Workouts entry
Workouts, from the Library workout workouts New workout
Notes note notes New note
Dashboards dashboard dashboards New dashboard
  • The default is the collection’s name plus “entry” or “entries”.
  • When you type your own word for one (“workout”), the app suggests the word for several (“workouts”). You can change it.
  • The starters come named. Notes is note / notes. Dashboards is dashboard / dashboards. Every Library starter brings its own names.

Where the names show

Place Example
+ buttons and the quick options of a tab bar “New dashboard”, “New note”
Toasts “Note moved to Trash · deleted for good after 30 days”, with Undo
Empty views “No notes yet”
Actions on several entries “Move 3 notes to…”
Search filters “Only notes”
The AI’s replies “I found 4 workouts this week.”
The slash menu in a Block page (later) “New note”
  • The names never change your data. Titles and file names stay as they are.
  • In a long label, the app cuts the collection’s name first, never the verb or the word “entry”: “New Very long collection na… entry”. See When text is too long.

How its entries show

When you put an entry in a tab or in an Entry block, you pick the entry, then Show: what part of it you see. Each collection has two settings for what Show starts with:

Setting Choices
Show in a tab one property (for example the “Dashboard” property) · the whole entry page
Show in a block a link · its card · one property

We set these defaults. You change them in the collection’s settings.

Collection In a tab In a block
Dashboards its Dashboard property its Dashboard property
Notes the whole note (its entry page) a link
Every other collection the whole entry page its card
  • These are only the starting choice. Each tab and each block can pick its own Show.
  • A tab or block that never picked its own Show follows the collection’s default. Change the default, and those tabs and blocks change with it. One that picked its own keeps it.
  • Example: in Diary, set Show in a block to the property Liked today. Put “28 Oct” in an Entry block, and it shows only what you liked that day, under a small header with its icon and name.
  • See Hubs and tabs and Block pages and dashboards.

Starter collections

Ready-made collections (a habit tracker, a reading list) come from the Library. When you copy one, it becomes an ordinary collection. Nothing about it is special after the copy.