For users on older versions or those who specifically insert the , the experience is slightly different.
This feature transforms Confluence from a "word processor" into a "knowledge base." It is perfect for:
Collapsible sections can be applied in various scenarios: collapsible section confluence
Since this feature has evolved recently, this review covers the (available in Cloud) and compares it to the legacy method (macros) that long-time users might still be using.
This keeps the page scannable while hiding deep instructions. For users on older versions or those who
. By using the native Expand macro , you can hide secondary details behind a clickable link, keeping your pages clean, professional, and readable. Why Use Collapsible Sections? Reduced Information Overload: Show only what’s necessary. Let users opt-in to the details. Better Navigation: Shorten long pages so readers can find the section they need without endless scrolling. Organized FAQ & Reference Material: Perfect for hiding answers to common questions or keeping "obsolete" but necessary reference data accessible but out of sight. How to Add a Collapsible Section in 3 Steps Adding an expander to your Confluence page or blog takes less than a minute: Insert the Macro: While editing, type
If you are on Confluence Cloud , start using the native collapsible sections immediately. If you are a power user needing styled accordions or complex dynamic hiding, look into the Atlassian Marketplace, but for 90% of users, the native tool is more than sufficient. Reduced Information Overload: Show only what’s necessary
Long pages become manageable. You can hide detailed instructions, technical specs, or optional background info.
: Place text, lists, or tables inside the macro body.
The most common way to create these sections is by using the native available in both Confluence Cloud and Data Center .