Steps

The Steps macro helps you present information as a clear sequence of actions. It divides a process or guide into individual steps, making long instructions easier to read and follow. Use it for tutorials, onboarding flows, troubleshooting guides, or any content that benefits from a structured, step-by-step approach.

Key Features

• Sequential structure — divides a process or instruction into clear step-by-step blocks.
• Customizable step titles — each step begins with a heading that serves as its title.
• Rich content — steps can include text, tables, images, code blocks, info panels, and other elements.
• Compact and clear view — in page view, only one step is displayed at a time, improving readability of long instructions.
• Interactive navigation — switching between steps is instant and does not require a page reload.

Macro Tutorial

To add Steps on your page insert the Steps macro:

Next, add content into the macro body following these rules for defining tabs:

• The first heading inside the macro is used as the tab title.
• The Divider macro is used as a separator between tabs.
• All content placed between a heading and the next Divider belongs to that tab.

In editing mode: you can add, remove, and organize content directly inside the macro.

In page view, steps appear compact and interactive; only one section is visible at a time.

This way you can structure large blocks of content into clear, switchable tabs.

Supported content

Supports any Confluence content (text, images, tables, code blocks, info panels, etc.)

Important

Action items (checklists) inside Steps are clickable, but their state is not persisted.

Limitation

Other Confluence macros are not supported inside Steps.

Configuration

The Steps macro provides one configuration option:

Parameter	Values	Default
Remember last step	None — does not save the last step; after reloading the page, the first step is displayed by default. Save step — the last opened step is saved and restored after reloading the page.	None

Behavior

• When inserted, the macro creates a container with multiple steps.
• The content of each step is edited directly inside the macro body.
• In page view, the step displayed by default depends on the Remember last step setting:
  • None — the first step is always shown when the page is loaded.
  • Save step — the last opened step is remembered and restored on the next page load.

Conclusion

The Steps macro is designed for breaking down complex processes or instructions into clear, manageable steps. It works out of the box with minimal setup, while the Remember last step option provides flexibility in how progress is tracked. Use it to make guides, tutorials, and procedures easier to follow, keeping your pages structured and user-friendly.