Skip to content

Blocks and charts

A block is one piece inside a Block page or a Dashboard property: a paragraph, a photo, a chart. In a Dashboard, each block sits in a tile, with a place and a size.

In the app you rarely see the word “block”. You click + Chart, + View or + Photo.

Writing blocks

Block What it is Example
Paragraph plain text “Long run before work.”
Heading a title for one part of the text “Week 3”
List a bulleted list, a numbered list or a checklist [ ] Buy milk
Quote words set apart from the rest “Run easy today,” said the coach.
Callout a short note in a box, so it stands out “Race on Sunday.”
Divider a line between two parts —
Code code shown as text. It never runs. pace = time / distance
Mention a link to another entry, made with @ “Finished @Dune today”

Media blocks

Block What it is Example
Image a photo or a picture, stored once in Attachments/ the view from the hill
Embed something from another website, shown in place a video of a running drill

Data blocks

Data blocks show your other entries.

Block Shows Reads Works in
Chart one chart, in one of the 22 chart kinds one collection or one global collection Block page and Dashboard
View a live view: table, list, board, calendar or any other view type. A new view that lives in the block, or an existing one, marked ↗. one collection or one global collection Block page and Dashboard
Entry one entry: a link, its card, or one property one entry Block page and Dashboard
Columns other blocks, side by side the blocks inside it Block page only (a Dashboard already puts blocks side by side)
HTML anything written in HTML, CSS and JavaScript, in a sealed frame only the data it declares Block page and Dashboard

A Code block and an HTML block are different. A Code block shows code as text. An HTML block runs it, in a sealed frame.

HTML blocks arrive later than the other blocks (stage 6 of the plan).

Anything a tab can show, a block can show. A tab shows a view or an entry, so the View block and the Entry block cover everything a tab points to. A tab and a block offer different Show choices for an entry (see Entry block). A hub is never a block. See Hubs and tabs.

View block

Setting Choices Example
Which view a new view that lives in the block, or an existing view from a tab bar, linked and marked ↗ a new “This week’s workouts” view, or the linked Workouts “Calendar”
What it reads one collection or one global collection Workouts
Filter its own filter, including “this entry’s date” Entry date is this week

A linked view is the same view as its tab, not a copy. Change it in one place and both change.

Entry block

An Entry block shows one entry. You pick the entry, then Show: what the block shows of it.

Setting Choices Example
Which entry any entry, from any collection “Weekly fitness”
Show a link · its card · one property one property: Grid
Header (for one property) the icon-and-name control: icon and name · icon only · name only, or hidden icon and name
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 with the entry’s icon and name. Click the header to open the entry. “Weekly fitness”, property Grid; the diary day “28 Oct”, property Liked today; a run, property Route (the map)
  • A block never shows the whole entry page. Only a tab does (see Hubs and tabs).
  • A dashboard inside a dashboard is an Entry block that shows its Dashboard property, in a Dashboard tile.
  • Edits change the real entry. It is the same entry, not a copy.
  • Embedded entries paint from memory, like everything else. A click never waits for them.

What a new Entry block shows

Each collection sets the default in its settings (see How its entries show). We set:

Collection A new Entry block shows
Dashboards its Dashboard property
Notes a link
Every other collection its card

Limits for a Dashboard or a Block page

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.

Rule Detail
Depth At most 3 levels: a dashboard in a dashboard in a dashboard. A deeper one shows as its card.
No loops An entry never shows itself, directly or through others. That block shows the card with “This would show itself”.
Room A tile that shows a Dashboard must be at least 6 columns wide and 4 rows high. A smaller tile shows the card. The minimum is a theme setting. A Block page has no minimum.
On a phone Tiles are full width, so only the depth and loop rules apply.
HTML blocks They keep their own limits (see HTML blocks).

See Block pages and dashboards for a diagram of the three ways.

The slash menu

Type / in a Block page to list the blocks and pick one.

(later) The slash menu will also list quick-create options. They are set per collection, like the + menu of a tab bar.

Rule Detail
The default option New note
The new entry’s Parent the entry you are typing in
What appears where you typed an Entry block, shown as a link
Labels use what one entry is called: “New note”, “New diary entry”

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.

Block sits in With “this entry’s date”, it shows
the Diary day “28 Oct” entries from 28 Oct only
a holiday entry, 1 to 14 Aug entries from 1 to 14 Aug

The filter changes only what the block shows. Every entry still shows in its own collection. See Filters, sorts and groups.

Chart kinds

The plan sets 22 chart kinds. Their names and settings are not decided yet; they will be listed here.

What is decided for every chart:

Rule Detail
Data source One collection or one global collection. A chart across collections reads a global collection.
Colours From your theme’s twelve chart colours, unless you set your own.
Parts you can style Axis, grid, legend, tooltip, series, labels.
Range A Chart block can have its own range navigation (for example, back one week).
Filter Its own filter, including “this entry’s date”.
Speed Charts are drawn in the background. A click never waits for a chart.

HTML blocks

Rule Detail
Where it runs A sealed frame: a separate small website that cannot reach the rest of the app.
What it sees Only the data its list declares. You see that list before you switch it on.
Made by you On.
Made by someone else (Library, shared space) Arrives switched off.
Made by the AI Needs your Approve.
Switching on one that runs a script A change only you can make: Face ID, a fingerprint, Windows Hello or your device password. One with no script needs only your tap.
Hidden collections Never offered to code someone else wrote.
Size At most 1 MB.
On a phone At most about 4 live HTML blocks at once.
When it starts After the entry page is drawn. It pauses when it is off screen.

Frames and tiles

Each block has a frame with parts you can style: header, title, body and range navigation. A Dashboard also has a setting for the gap between its tiles. To style every dashboard at once, apply the design to the Dashboards collection (the place “This collection”). See Themes and Where a design applies.