How to Add Expandable Sections in Confluence Easily 2026
By Impran M N
A wall of dense technical detail overwhelms readers before they get to the important parts. This guide shows how to add collapsible expand sections in Confluence in 2026 to keep pages scannable while still preserving detail.
01Open the expand macro
In edit mode, type `/expand` or `/collapse` and hit Enter to drop the interactive collapsible frame.
02Title the section
Click the header input strip to type a clear, descriptive title for what's hidden inside.
03Add your content
Move into the main container block to type detailed explanations or drop in structured data tables.
04Set the default state
Use the sidebar options drawer to toggle whether the section loads expanded or fully collapsed by default.
05Publish
Review your layout and click Publish to go live.
Frequently asked questions
Can I set an expand section to be open by default?
Yes, the macro's configuration lets you choose whether the block loads expanded or fully collapsed.
Can I put a table inside an expandable section?
Yes, you can drag and drop complex bulleted lists, code blocks, or data tables inside the macro boundary.
Does hiding content behind an expand block slow the page down?
No, collapsing heavy data arrays actually helps the page render faster and reduces scroll length.
Are expand sections good for building an FAQ page?
Yes, layering multiple expandable rows together is a common way to build interactive FAQ hubs and technical spec summaries.
Watch the full walkthrough
The same steps, demonstrated on screen from start to finish.



