Block pages and dashboards
A Block page and a Dashboard are the two property types that hold blocks. A block is one piece: a paragraph, a photo, a chart.
What a block is
A block is one piece inside a Block page or a Dashboard property. In the app you rarely see the word “block”. You click + Chart, + View or + Photo, and the block appears where you are.
| Kind | Blocks | Example |
|---|---|---|
| Writing | paragraph, heading, list (bulleted, numbered, checklist), quote, callout, divider, code, mention | “Long run before work.” |
| Media | image, embed | a photo of the view from the hill |
| Data | Chart, View, Entry, Columns, HTML | a chart of steps per day |
The data blocks show your other entries:
| Data block | Shows | Example |
|---|---|---|
| Chart | a chart of a collection or a global collection | Steps per day |
| View | a live view (table, list, board, calendar or any other view type) of a collection or a global collection: a new one, or an existing one marked ↗ | This week’s workouts, as a table |
| Entry | one entry: a link, its card, or one property | Your best run, as its card |
| Columns | other blocks side by side. In a Block page only: a Dashboard already puts blocks side by side. | a photo next to a paragraph |
| HTML | your own HTML, CSS and JavaScript, in a sealed frame | a 3D globe of your runs |
A code block shows code as text. An HTML block runs your code, in a sealed frame. Every block and its settings are on Blocks and charts.
Block page and Dashboard
| Type | Holds | Example |
|---|---|---|
| Block page | blocks from top to bottom: text, photos, charts | “Liked today” in Diary |
| Dashboard | blocks as tiles that you drag and resize | the tiles of a dashboard |
Block pages
A Block page holds blocks in order, from top to bottom. It is where you write.
- A new collection starts with one Block page property called “Page”. You can rename it, remove it or add more.
- A collection can have several. Example, a Diary collection:
| Property | Type |
|---|---|
| Mood | Number |
| Liked today | Block page |
| Didn’t like | Block page |
| Grateful for | Block page |
- Each Block page is its own field. Search finds words in each one. The AI can read only one: “What was I grateful for this month?” Formulas can use it.
- The Title is not a Block page. It is built into every entry.
- Type
@and pick an entry to mention it: “Finished @Dune today”. Dune then shows “Mentioned in: 19 Oct”. Nothing moves. See Links between entries. - A Block page merges word by word. If you write on your laptop and your phone at the same time, or a coach edits the same text, no words are lost.
Dashboards
A Dashboard holds blocks as tiles. Each tile holds one block and has a place and a size on a grid of 12 columns.
- You drag a tile to move it, and drag its corner to resize it.
- On a phone, the tiles stack into one column, in reading order: left to right, then top to bottom.
- A Dashboard merges tile by tile. If you move one tile on your laptop and another on your phone, both moves are kept.
- Any collection can have a Dashboard, not only Dashboards. Example: each Diary day has a small “Today” Dashboard property with a steps chart and a sleep chart.
A dashboard is an entry in the Dashboards collection. Its Dashboard property is called “Dashboard”.
Embed anything a tab can show
Anything a tab can show, a block can show. A tab shows a view or an entry (see Hubs and tabs), so two blocks do the same. For an entry, a block offers its own Show choices, below.
- A View block shows a view of a collection or a global collection. It is either a new view that lives in the block, or an existing view, linked and marked ↗.
- An Entry block shows one entry. You pick the entry, then Show: what the block shows of it.
| Show | What you see | Example |
|---|---|---|
| A link | one line: its icon and title, like a sub-page link in Notion | the note “Running plan” |
| Its card | its card, drawn by its collection’s card design: a bit of everything | your best run |
| One property | only that property, drawn the way it looks on the entry page, under a small header | “Weekly fitness”, property Grid, inside “Overview” |
- Its card gives a bit of everything. Each collection designs its own card.
- One property gives the big part. Examples: a dashboard’s Dashboard property (only its charts); the diary day “28 Oct”, property Liked today (only that text); a run, property Route (only the map).
- The header. A block that shows one property has a small header on top: the entry’s icon and name. Click it to open the entry. The header is the icon-and-name control, so you can hide it.
- A block never shows the whole entry page. Only a tab does. See Hubs and tabs.
What a block shows at first
Each collection sets what its entries show in a new Entry block. We set these defaults:
| Collection | A new Entry block shows |
|---|---|
| Dashboards | its Dashboard property |
| Notes | a link |
| Every other collection | its card |
You change the default in the collection’s settings. See How its entries show. You change it for one block in the block’s settings.
- A dashboard inside a dashboard is an Entry block that shows its Dashboard property, in a Dashboard tile.
- It is the same entry, not a copy. An edit inside an embed changes the real entry.
- Embedded entries paint from memory, like everything else. A click never waits for them.
- Hubs are not blocks. A hub is only a tab bar in the sidebar.
Limits
A Dashboard or a Block page can hold more embeds. So these limits apply when an Entry block shows a Dashboard or a Block page as its one property.
| Limit | Rule |
|---|---|
| Depth | At most 3 levels: a dashboard in a dashboard in a dashboard. A deeper one shows as its card. |
| Loops | An entry never shows itself, directly or through others. That block shows the card with “This would show itself”. |
| Room | In a Dashboard, the tile must be at least 6 columns wide and 4 rows high (a theme setting). In a smaller tile the entry shows as its card. |
| Phones | Tiles are full width, so only the depth and loop rules apply. |
| HTML blocks | They keep their own limits. See Blocks and charts. |
Make entries from the slash menu
- Typing
/in a Block page lists the blocks, and New note. Type/noteor/pageto find it fast. - The new note goes in your Notes and gets this entry as its Parent. An Entry block, shown as a link, appears where you typed. It works like a sub-page in Notion. The note opens in the same tab, and Back returns you here.
- (later) The same menu will also list quick-create options, set per collection like the
- menu of a tab bar, such as “New diary entry”. The labels use what one entry is called. See What one entry is called.
Why two types, not one type with two looks
They save different things. A format, such as a Number shown as stars, never changes what is saved. A Dashboard saves each tile’s place and size too. So a Dashboard is its own type.
Switching keeps every block
You can change a Block page into a Dashboard, or a Dashboard into a Block page. No block is lost.
| You change | What happens |
|---|---|
| Block page → Dashboard | Each block becomes a full-width tile, in the same order. A Columns block becomes tiles side by side. |
| Dashboard → Block page | The tiles become blocks, in reading order. Tiles side by side become a Columns block. |
The “this entry’s date” filter
A Chart or View block inside an entry can use the filter this entry’s date. It then shows only the entries whose Entry date falls on this entry’s Entry date, or inside its date range.
Example: the Diary day “28 Oct” has a Dashboard called “Today”, with a steps chart and a sleep chart. Both charts use this filter, so both show 28 Oct only. Open “27 Oct”, and its charts show 27 Oct.
The filter changes only what the block shows. Every entry still shows in its own collection. See Filters, sorts and groups.
Presets can fill a Block page or a Dashboard
A preset can hold starting blocks for a Block page or a Dashboard property.
Example: in Diary, the “Diary day” preset fills the “Today” Dashboard property with a steps chart that reads Activity and a sleep chart that reads Sleep. Both use “this entry’s date”. So every new diary day starts with charts for its own day.
In your folder
All the Block pages and Dashboards of an entry stay in one markdown file. Marker lines, such as
<!-- document: Liked today --> and <!-- grid: Today -->, split them. A chart or a view is
written as a code block that holds its settings. Markdown apps such as Obsidian show it as
code, and nothing is lost. The full format is on Block page
and Dashboard.
A page comes back exactly as you left it, block for block. Some things have no markdown, such as
a toggle, a colour, a bookmark card or a column’s width. They sit in a small note at the end of
the block’s line, for example - Week plan <!-- kzx {"type":"toggleListItem"} -->. Markdown apps
hide these notes.
You can edit the file in any app. Kaizendex reads it safely: it keeps only the kinds of blocks it knows, named colours and safe links (web, email, phone and Kaizendex links). A link it does not trust keeps only its words.