> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autype.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reusable Blocks

> Insert organization-managed Extended Markdown blocks as live references or independent snapshots.

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.

```markdown theme={null}
::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](/getting-started/editor/sidebar-reusable-blocks)
or through the Developer API and MCP tools.