Another best practice is avoiding "accordion nesting" (accordions within accordions). While technically possible, this creates a confusing, labyrinthine experience. If content is that complex, it likely belongs on a separate sub-page. Additionally, never hide critical warnings or mandatory instructions inside an accordion. Information that all users must read—such as legal disclaimers or security alerts—should remain visible in the open page body.
Note: Standard Confluence comes with the "Expand" macro, which functions as a single accordion panel. confluence accordion macro
In the world of technical documentation and knowledge management, "Wall of Text" is the enemy. When users open a Confluence page and see 5,000 words of uninterrupted paragraphs, their instinct is to close the tab. In the world of technical documentation and knowledge
At its core, the Accordion Macro is a dynamic container system. When inserted into a Confluence page, it creates a vertically stacked list of collapsible sections, or "panels." Each panel consists of a visible header (the title) and a hidden content area. The metaphor of a musical accordion is apt: as one section expands, others typically remain collapsed, though Confluence allows for configurations where multiple sections can be open simultaneously. The user clicks on a header to reveal the content beneath, thereby "playing" the page by choosing which information to expose. When inserted into a Confluence page