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.
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.