Can a Table of Contents link to Tabs in a Mosaic Tabs macro?

[Matthew Burfeind]

We have a user who has created a couple of blocks on a page using the Mosaic Tabs macro, and is using Headers to create a Table of Contents. Above each Tab set, there is an H1, and each tab section uses an H2. The Table of Contents at the top of the page shows the hierarchy, and the top-level (H1) titles link to the appropriate place on the page, but the H2 header links (in the tabs) do not work. Is this a bug?

[Peter_DevSamurai · Accepted solution]

Hi @Matthew Burfeind , 

The linkings to H2s inside tabs (like Mosaic Tabs) often fails because tab content is dynamically loaded/hidden via JS, breaking anchor jumps. It's not a bug in Confluence but a limitation. In Premium plan there is no native fix but you can work around this:

1) Mosaic Settings: Check Mosaic settings for "deep linking" or tab-switching on anchor. If not, contact Kolekti support via their Nolt board or Marketplace -> suggest a feature for ToC compatibility.

2) Manual ToC with Anchors: Remove auto-(Table of content) ToC. List headings manually > Highlight each > Insert link > Anchor to H2 ID (right-click H2 > Copy link > Use fragment like #heading-id). For tabs, add JS if Mosaic supports custom code (rare in Cloud). You can refer to this similar article. 

3) Switch to Expand Macro: Use native Expand instead of tabs—ToC links work perfectly as content isn't JS-hidden. Group H2s under Expands for similar folding.

If it's critical, upvote similar requests in Confluence Feature Requests (search "ToC tabs integration").

I hope everything works out for you. 

Best,

Peter

[Zoriana Bogutska_Kolekti]

Hi @Peter_DevSamurai  highly appreciate your help in finding a solution for this request.

@Matthew Burfeind, I represent the Mosaic team here:)

Short answer to your question - yes, the table of contents link to Tabs in a Mosaic Tabs macro. 

I tested and found an additional solution. Yes, you can't use Tab's name as H2 or other headers because of Atlassian limitations. But you can add any headers inside tabs and they will work for table of content. If you want the table of content to lead to each tab, I recommend you to copy the tab's name and paste it inside tabs using different headings e.g. in your case, as H2.

From the screenshot below, you can see how it works for me.

Please let me know if it works for you.