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