---
title: "Reusable content blocks"
url: "/help/buuk/reusable-content-blocks"
updated: "2026-10-22T11:13:35.950Z"
---
# Reusable content blocks

Some copy repeats across articles: refund policy, pricing boilerplate, a standard security warning. A reusable content block stores it in one place, and every article that uses it shows the current version.

## Create a block

1. Press `/` and choose **Reusable block**. The content blocks panel opens.
2. Choose **New block**, give it a name, and add a short description to help teammates pick it later.
3. Select **Create & insert** to place the block at your cursor, then write its content with the same editor.
4. Save when the content is final.

Blocks belong to the workspace, so every article can use the same set.

## Insert a block

1. Press `/` and choose **Reusable block**.
2. Search by name, description, or key to find the block.
3. Select **Insert** to place it at the cursor.

## Edit once, update everywhere

An article stores a reference to the block, not a copy. When a reader opens a page, Buuk resolves the block and expands its current content.

Open the block in the picker to edit its name, description, or content and save. The updated version shows in every article that uses it — including FAQ, Guides, and the widget — the next time those pages load. The picker says it plainly: edits sync everywhere a block is used.

## Delete a block

Deleting a block removes the stored copy. Articles that referenced it show nothing in its place, and the editor asks you to confirm that trade-off first.

> [!WARNING]
> The expand step happens at load time. Edits reach every page with the block, without you republishing each one — but check them once after a big edit.

## When to use one

- **Legal and policy notes **— refund rules, data handling, security warnings readers should always see.
- **Pricing and plan boilerplate **— the sentence every billing article repeats.
- **Standard warnings **— the danger callout that belongs at the top of several how-tos.

## Related

- See [Editor blocks](./editor-blocks) for the full block list.
- Read [Callouts](./callouts) to shade what blocks should say.
- See [Tables](./tables) for comparing options inside a block.
- Find stale copy with [Doc health and freshness](./doc-health-and-freshness).