DOCUMENTATION

Page

Last updated May 2026
Advanced Block
All plans

A clickable row that creates and links to a child document, lazily — nothing is created until you first click it. The block shows a file icon and the linked page's cached title (or “Untitled” before it's linked).

Adding a Page block

/ → Page
Type /page on any empty block. This inserts the block itself — it does not create a child document yet.
Block palette
Click + on any block → Advanced → Page.
No document is created when you insert the block. The child document is only created the first time you click the block — an Untitleddocument is created as a child of the current one, its ID is saved into the block's metadata, and you're navigated straight to it. Every click after that just navigates to the already-linked document.

Behaviour

pageDocumentId
Stored in metadata once a document has been linked (i.e. after the first click). Absence of this field is what triggers the create-on-click behavior above.
pageTitle
Cached label shown in the block. There is no automatic refresh — if you rename the linked document elsewhere, this block keeps showing the old title until something else updates it.
Navigation
Clicking a linked block navigates via a full browser navigation (window.location.href), not client-side routing — the page reloads.
There is no “not linked” or broken-link visual state. A block with no linked document and a block linked to a document titled “Untitled” look identical.

Published pages

Page blocks do not render at all on published pages — the public renderer has no case for this block type, so it disappears entirely from the published site. Treat this as an editor-only navigation aid between draft documents, not a way to link between pages on your live site.