Reusable Blocks

Reusable blocks are organization-wide snippets such as legal clauses, company descriptions, disclaimers, or standard offer sections. Each block is versioned and stored as Extended Markdown.

Reference mode

Reference mode keeps the document connected to the reusable block. latest uses the current active version when the reference is resolved.

::block{id="550e8400-e29b-41d4-a716-446655440000" version=latest mode=reference locked=true}

Use a known block ID returned by the sidebar, API, or MCP tools. Do not invent IDs.

Snapshot mode

Snapshot mode copies the block content into the document. The copied elements can be edited independently and do not change when the library block is updated. The visual editor exposes both actions:

Reference inserts a linked, read-only block.
Copy inserts an editable snapshot at the current cursor position.

Version behavior

Setting	Result
`version=latest`	Resolve the current active block version
Pinned version	Keep using one specific block version
`locked=true`	Keep a reference read-only in the visual editor
Fallback content	Preserve renderable content if a referenced library block is later unavailable

Publishing changed block content creates an immutable version with an optional changelog note. Restoring an older version creates another version instead of rewriting history, so pinned references continue to resolve exactly as before. Metadata-only changes do not publish a content version. Manage blocks in the Reusable Blocks sidebar or through the Developer API and MCP tools.

​Reference mode

​Snapshot mode

​Version behavior

Reference mode

Snapshot mode

Version behavior