Skip to content
On this page
Capacities Believer

Block-based linking ​

Block-based linking currently is an early-access feature for Capacities Believers.

Capacities lets you link to individual blocks inside of an object. We call this concept block-based linking or just block references. This not only let you link to other blocks, but 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. Now select "Copy block reference".

Block references

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. Note that inserting the link at the start of an empty block will automatically generate an embedded view of that block. Pasting a link somewhere inside your text will result in a simple link to that block.

Block references

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.

Block references

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.

Block references

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.

Block references



🤔  Do you find this explanation unclear or feel like something is missing in the docs?

With your help we can make the docs better for everyone. So just let us know, and we’ll improve it ASAP!

📨  Did reading the docs make you think of any product improvements?

Please let us know if you have an idea for a feature, think that something is missing or see a conceptual inconsistency that could be fixed. Just post it on our feedback board and discuss it with us and other users!

Built with ❤️ and ☕️ in 🇪🇺.