3 posts tagged with "macros"

Long pages die from scroll fatigue. Onboarding checklists, troubleshooting trees, API reference details, legal disclaimers — content that only some readers need some of the time is the canonical use case for collapsible sections. Confluence ships a native expand macro for exactly this, and for many pages it's enough.

This guide covers how the native expand works, where teams typically outgrow it, and what a styled accordion macro adds — so you can pick per page, not per vendor.

Tabs are the layout workhorse of product pages, API references, and comparison docs: they let one page hold three versions of the truth (per environment, per plan, per language) without tripling the scroll length. Confluence's answer to tabs has changed over the years, so this page sorts out what exists today and which to use when.

Take a look at your most-visited Confluence page right now. Does it look like it belongs on the modern web — or does it look like internal documentation from 2015?

If your answer is the latter, you're not alone. Teams across thousands of Confluence sites tell us the same story: "I know exactly what I want my page to look like. I just can't make Confluence do it."

In this guide, we'll show you six concrete ways to level up your Confluence pages — from Medium-style reading layouts to interactive surveys — all without leaving your editor.