How to make Table of Contents find content in Expand macros

Question

Hi all,

By default, links in the Table of Contents for a Confluence page will not take you to the content if it's nested in an Expand macro that is collapsed. If the section is expanded, then it is able to find it. I understand that is expected behavior and not a bug.

Is there a workaround for this? I have users with fairly complex Confluence pages and they would like to be able to keep using the Expand macros because it keeps things tidy, but it also makes it so they can't easily navigate to content in those macros from the ToC.

Any suggestions are greatly appreciated. Thank you!

Kristian Klima_gtcuat · Answer

Yes @Barbara Szczesniak a little adjustment in the information architecture.

BTW, the best practice is to reserve H1 for the page title and only use H2, H3 etc. within the actual page content.

Barbara Szczesniak · Answer

So, I guess the key is to not put headings at a level that will appear in your TOC within the expand macro.

It all comes down to planning your organization of the information and (maybe) only including Heading 1s and 2s in your TOC macro.

Kristian Klima_gtcuat · Answer

Exactly, a simple tweak of the content would do the trick.

Example:

Heading about something

Expand the following section to learn more about whatever the Heading hints at.

EXPAND MACRO.

This way you're actually making it obvious to the reader there's an actionable item ahead.