Skip to content

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

The same four blocks, a heading, a paragraph, a photo and a chart, shown two ways. In a Block page they sit from top to bottom. In a Dashboard they are tiles: the paragraph and the photo sit side by side. Switching the type keeps every block.Block pageblocks from top to bottomHeading: Long runParagraph: Legs felt fresh.Photo: the view from the hillChart: steps per dayDashboardtiles on 12 columns: drag, resizeHeading: Long runParagraphPhotoChart: steps per dayswitch the typeevery block is kept
A Block page stacks its blocks. A Dashboard gives each block a place and a size.
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.
The dashboard Weekly fitness in an Entry block, shown three ways. A link: one line with its icon and title. Its card: a bit of everything. One property, its Dashboard property, the default for a dashboard: a small header with its icon and name, then a chart, an entry and a view.A linkone lineWeekly fitnessIts carda bit of everythingWeekly fitnessa dashboardupdated todayOne propertyits Dashboard property (the default)Weekly fitnessChartEntryView
One Entry block, three ways to show the entry. Show its Dashboard property, and a dashboard sits inside a dashboard.

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 /note or /page to 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.

See Changing a property type.

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.