How to include the content inside of localtabs in the TOC macro?

We have inserted localtab groups and localtabs to help us structure our content in Confluence. However, now the TOC macro no longer works, and will not jump the user directly to the content located in the hidden DIV of the tab.

Are there any workarounds that you've tried and can recommend? We'd love to use the TOC macro's automation, but worst case scenario, we'd even accept a manually customized TOC.

3 answers

0 votes

Hi Kristina,

Is there any error appearing in Confluence logs regarding TOC macro? Do it works on other browsers? Does this happens to the latest version of Confluence?

If you try to create a new page in Confluence and use the TOC macro, do it work?



Thank you, Rodrigo Girardi Adami – apologies that it has taken me a while to respond back to your questions.

We are using version 5.4.2 of Confluence. The TOC links do not work on newly created pages, and they do not work in Chrome, Firefox or IE 8.

I am still trying to track down logs to tell you whether we get error messages, but actually don't know whom to ask for those or where that would be tracked inside my organization. Can you say anything more about the types of administrator permissions that would need to be enabled in order to see error logs?


Thanks so much, again!




Hi Kristina,

I had the same issue in 5.4.2. The localtab headings weren't listed in the TOC regardless of Browser.

We upgraded to 5.6.1 and now the TOC lists the heading in the localtabs. However, the limitation is that it only recognizes h3, h4, and h5 within the tabs. And even though all the tabs are listed in the TOC, only one tab is activated (the other headings are listed but the navigation doesn't work).

If H1, h2, and h6 title headings are used, then they aren't listed in the TOC (at least on my version). But I don't use those for tabs anyway. So I don't mind.

I don't know if there is a way to fix the issue on your version, but if you can upgrade, I'd recommend at least upgrading to 5.6.1. 

If you want to submit a ticket, go to and create an account if you haven't already.


same issue using 5.8.14: The TOC macro lists headings in all localtabs, but links only work for the currently opened/active tab; desire is for TOC link to open respective tab

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Dec 18, 2018 in Confluence Cloud

Happy holidays from our team to yours!

Hi Community!  2018 was filled with changes for our team, both big and small, and we've taken a lot of time to both celebrate our wins and recognize areas of improvement. One thing that we're a...

483 views 3 18
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you