---
title: "Steps"
url: "/help/buuk/steps"
updated: "2026-10-22T11:13:32.236Z"
---
# Steps

A steps block is a numbered procedure with a title on each step. Readers who already know part of the task can jump straight to the step title they need. [Quickstart](./quickstart) on this site is built from one.

## Steps or a numbered list

- Use steps when each item needs a title, its own paragraph, or extra blocks such as code or images.
- Use a numbered list for a short run of plain sentences where titles would feel heavy.
- Both communicate order. Steps scale better, because a step can grow a screenshot or a code sample without turning the list into a wall of text.

## Build a procedure

1. Press `/` and choose **Steps** from **Callouts & blocks**. A new block starts with two steps titled `First step` and `Next step`.
2. Replace the titles with a verb phrase — Create your workspace, Publish, and so on.
3. Write the instruction under each title. Add a step for anything you would have written as a second sentence.

Blocks nest inside a step: paragraphs, lists, images, code blocks, callouts — anything you would use on the page.

1. **Open the article**
   Go to **Articles** and open the draft you want to edit.

2. **Insert the block**
   Press `/` and choose **Steps**.

3. **Title each step**
   Readers skim titles. Say what the step achieves, not which button it clicks.

> [!TIP]
> One action per step. If a step contains the word then, it is probably two steps.

## Related

- [Editor overview](./editor-overview)
- [Callouts](./callouts)
- [Accordions](./accordions)
- [Quickstart](./quickstart)