Two ways to create a collapsible section in Confluence
Share on socials
Two ways to create a collapsible section in Confluence Cloud | 1-minute demo
Jump to Section
Jump to section
What are collapsible sections?
How to create a collapsible section
Method 1: Built-in Expand macro
Method 2: Advanced Expand macro
- How to use Advanced Expand
- Advanced Expand Features
Use cases
When to use collapsible sections
When NOT to use collapsible sections
Give Confluence users the essential information they need without overwhelming them. It’s easy with the help of collapsible sections!
Your Confluence pages contain plenty of useful content, but there’s so much information that it feels overwhelming. How can you engage users without compromising on delivering your message?
There are two distinct ways to create collapsible sections in Confluence, depending on your needs. Read on to learn about Confluence’s standard tool and how the Advanced Expand macro can help you create better, more engaging pages in no time.
What are collapsible sections?
Collapsible sections, also known as expands, are interactive elements that users can click on to reveal (or hide) information. They’re an excellent way of saving space on a Confluence page, keeping it tidy and easy to scan.
How to create a collapsible section in Confluence
There are two different ways to create a collapsible section, depending on your requirements. Read on to discover which is right for you:
Method 1: Confluence’s built-in Expand macro
Best for: Standard, functional collapsible sections where branding isn’t a priority, or there’s limited content.
To create a simple collapsible section in Confluence, use the built-in Expand macro. It’s free and ready to use, with no extra add-ons.
- On your page, type the shortcut /expand and select the Expand macro.
- Click the title placeholder to type a name for your section.
- Click the content area below the title to type or paste your information.
- Click Save to save your changes, then Publish or "Update your page.
⚡️ Pro Tip: Need multiple collapsible sections? You can easily duplicate your collapsible section by clicking the Copy icon (it looks like two overlapping pages).
Benefits:
- Easy to use: It's quick and straightforward to add one to your page, meaning you can start organising your pages straight away.
- Comes with Confluence: Because it's a free, built-in feature, you don't need to worry about getting admin permission to install it.
Drawbacks:
- Easy to miss: The standard Expand macro header is small and plain, meaning users might skim past important information.
- Limited styling: You can’t change the header background colour, add icons, or customise the style to match your company brand.
- Can't be nested: You can’t nest them in other macros, limiting what you can actually do with them.
Looking for a more engaging alternative? Read on…
Method 2: Advanced Expand macro (from Mosaic)
Best for: Creating cleaner, eye-catching pages with custom styles and branded headers.
While Confluence’s built-in tool is functional, Mosaic’s Advanced Expand macro is designed to help you organise your page with style.
Just three different ways you can style the Advanced Expand macro
The Advanced Expand macro features a fully customisable header that makes your sections pop, meaning fewer users miss important information. You can also nest tables, images, and even other macros inside.
How to use Advanced Expand:
Keen to learn how to use the Advanced Expand macro on your Confluence pages? Here’s how to do it:
- Install Mosaic: Content Formatting Macros & Templates (it’s free for 30 days!)
- In edit mode, start typing /advanced expand and click on the Advanced Expand macro.
- Type your header title and add any content to the body, including text, Confluence macros, images, and tables.
- Customise your collapsible section. You can:
- Choose from three header styles
- Change the header background and accent colours
- Add an icon to the header for visual context
- Customise the alignment, heading size, font size, and font style of the content inside your collapsible section.
- Press Save, then Publish or Update your page to see it in action.
⚡️ Pro tip: Advanced Expand macros are super flexible. You can nest them inside other structural macros from Mosaic, like Tabs or Backgrounds, to create rich, interactive layouts.
Features of Advanced Expand:
- Custom styles: Use any header colour so your sections aren’t missed.
- Flexible nesting: Nest Advanced Expand inside other macros (like Tabs or Backgrounds) for sophisticated layouts.
- Rich content: Use built-in Confluence macros within the collapsible section to make content more engaging and add more structure.
- Standout Headings: Change the size of your heading to really make it stand out on a page.
- Detailed formatting: Format content inside your collapsible section using alignment, font colour, heading size, and more options.
Get hands-on with the Advanced Expand macro and more!
Use cases for collapsible sections in Confluence
Collapsible sections are useful for breaking up long-form content and hiding information that might not be relevant to everyone. Here are three ways to use them on your Confluence pages:
FAQs
Nobody wants to read every single FAQ. Thankfully, collapsible sections keep all the irrelevant answers hidden away from users.
By combining Advanced Expand with Tabs (both included with Mosaic), they turn a wall of dull, hard-to-read text into neatly categorised FAQ that stay tucked away unless a user is genuinely interested.
You can embed the Advanced Expand macro inside other macros, like Tabs
Documentation
If your documentation contains additional context or information that isn't applicable to everyone, hiding it can help reduce page length and make it easier for others to read. For example, for software troubleshooting, you could use a separate expanding section for each issue type (see below for an example).
Task lists
For bigger projects with many subtasks, breaking each list into a separate section can be useful. With collapsible sections, you can help team members focus on the step at hand, removing the rest of the noise.
Reasons to use a collapsible section in Confluence
- They help keep pages shorter, giving users a more seamless experience when trying to locate the section they want to refer to.
- A less visually overwhelming page makes the information more accessible to users, meaning they’re more likely to stay on your web page rather than going elsewhere.
- Collapsible sections are a great solution for pages that contain a lot of information but still need to be mobile-friendly.
When not to use a collapsible section in Confluence
Collapsible sections are great, but they aren't always the answer. If you have a very long page, asking users to click open dozens of sections can become tiresome.
For those situations, Mosaic offers a fantastic alternative: Tabs. Spreading information across several tabs keeps your page short while making it easy for users to find exactly what they need with a single click. Sound good? See our guide to creating Confluence tabs.
Now you should have the tools you need to provide a better, more customisable reading experience for the users who most need the content you have to offer - it’s a win-win!
Unlock new ways to improve your user experience
Mosaic comes with Advanced Expand, Tabs, and many more macros to make pages easier to read and navigate.
Written by