Block-based linking

Capacities lets you link to individual blocks inside of an object, and reference them in other pages. We call this concept block-based linking or just block references.

Update

You can now use block references within the same object. This feature was requested in this ticket and has been released in July 2025.

This not only lets you link to other blocks, but it also lets you embed individual blocks and their children inside another page.

Here is how it works:

Go to a block you want to link to or embed elsewhere. Open the block menu by clicking on the handle with the six dots at the top left. Go to Copy > Copy block reference.

This will copy the link to this block to your clipboard. The last step is to paste this link at the place where you want to link or embed the block.

If you paste this into an empty block, it creates an embedded view of that block.

Pasting a link somewhere inside your text will result in a simple link to that block.

An embedded block is identical to the original. This means that any edits will occur in all places where this block is used. This concept is called transclusion.

You can jump back to the original context of an embedded block by clicking on the link at the top left, which displays the name of the object the block originates from. If you go to the referenced block in its original context, you will notice the small icon with two arrows pointing left and right with a counter. This indicates how many times the block is being referenced.

If you click on this icon, you get a list of all objects from which the block is being referenced. Clicking on them will lead you to the exact position. Note that you can use the same modifiers as explained in navigation to open the block reference in the side panel or a new tab.