***
## Chapters for real-world scenarios
| Scenario | Recommended configuration |
|---|---|
| Onboarding guide covering several standalone tasks | One chapter per task, with **Reset step numbering** enabled |
| Long installation walkthrough with a single continuous sequence | Chapters at each stage, with **Reset step numbering** left off |
| Guide that splits into an admin path and an end user path | One chapter per audience, named after the role |
| Release walkthrough covering multiple new features | One chapter per feature, with **Show total steps in chapter** enabled |
| Short guide of fewer than ten steps | No chapters; the guide reads better as one sequence |
***
## Adding a chapter
1. Open the Step by step guide you want to organize into sections.
2. Scroll to the step before which the new section should begin.
3. Hover between two steps, the Add () button appears.
4. Click the Add () button and select **New chapter**. The **Add new step** confirmation appears, noting that the addition also applies to the corresponding step in the guide's other languages.
5. Click **Add** to confirm. The chapter is added at that position and the **Chapter** panel opens on the right.
6. In the **Title** field, enter a name for the section.
7. In the **Description** field, enter a short summary of what the section covers.
:::(Info) ( NOTE)
Select the content in the **Description** field to access the basic formatting tools: Bold (), Italics (), Underline (), Ordered list (), Unordered list (), and Hyperlink ().
:::
8. Click the **Rephrase with AI** icon () next to the **Title** or **Description** label to refine the wording of either field.
Repeat these steps wherever you want a new section to begin.
***
## Changing the chapter background
Every chapter is created with a default background image.
1. In the **Chapter** panel, click **Replace image** under **Background** section.
The **Select chapter background** dialog opens.
2. In the left pane of the **Select background** dialog, select a tab:
- Background - A still image.
- Animated background - A moving cover.
3. Select the background you want.
4. Click **Insert**.
***
## Configuring the chapter cover
The **More** section of the **Chapter** panel controls what appears on the chapter cover.
| Option | Description | Default |
|---|---|---|
| Show chapter number | Displays the chapter number above the title, such as Chapter 2. | Selected |
| Show total steps in chapter | Displays the number of steps the chapter contains. | Selected |
| Reset step numbering | Starts the chapter at Step 1 instead of continuing the count from the previous chapter. | Not selected |
***
## Best practices
* **Name chapters after the task they cover** - A title such as "Create your first form" tells a viewer more than "Chapter 2."
* **Place the chapter before the first step of a section** - The cover introduces the steps that follow it, not the ones before it.
* **Match step numbering to the guide's structure** - Enable **Reset step numbering** when each chapter is a standalone procedure. Leave it off when the guide is one continuous sequence, and viewers need a running count.
* **Keep descriptions to a sentence or two** - The cover is a signpost, not a summary of the section.
* **Add chapters only when the guide needs them** - A short guide reads better as a single sequence than as a set of one-step sections.
***
## FAQ
Can I add chapters to a video or interactive demo?
No. Chapters are available in Step by step guides only.
What happens to step numbers when I enable Reset step numbering?
The chapter starts at Step 1 rather than continuing the count from the previous chapter. Chapters that do not have the option enabled continue the running count.
Can I use a chapter without a background image?
Yes. Click the Delete icon in the top-right corner of the background card in the Chapter panel to remove the default image.
Which fields can Rephrase with AI rewrite?
Both. The Rephrase with AI icon appears next to the Title label and the Description label, and rewrites whichever field you click it for.