Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Using panel titles in Table of Contents

Hello all,


I'm currently trying to get titles used in the Panel macro into a table of contents. Is this possible or do I have to add these in a different way?


3 answers

I have added h2. text as the first line within my panel and made it the panel title / header. Then added the panel content under the h2. text.

I agree panel titles should have an "include in TOC" check box option, but this works with less effort than the Anchor macro option

I would love to see a way to easily include panels in the ToC while still formatting the content itself as paragraph. How about a checkbox for "include in ToC" or a way to format the panel title in the edit dialogue for the panel?


For now, I got around it by adding a heading in white (invisible) text above the panels.

just did the same. Thanks

0 votes
AnnWorley Atlassian Team Sep 18, 2017

The table of contents (TOC ) macro picks up Headings so if you format the titles within the macro as Headings they will be linked in the TOC.

Screen Shot 2017-09-18 at 4.43.34 PM.png

If you need the TOC to link to the title of the panel macro itself, you will have to build the TOC manually using the anchor macro above each panel, and links to the anchors.

That's sub-optimal. :(

Thats not good indeed, it would be nice to be able to add headings to panel titles so that it appears in the TOC

@AnnWorley Is there an open suggestion that we can vote on to make the panel title 'findable' in table of contents macro?

Like Pratik Jain likes this

(even if we can default it to h3) :D

I was looking to use panel title in a TOC as well... Boss wants a TOC with links to make getting to a topic someone is looking for quickly. I used panels and have everything looking organized and sorted. Sad that you need to add another layer of work into the page and that it isn't simple to use them in the TOC and not have to redo everything I started.

OMG!!! This is such an inefficient thing to do !! Why can't you just have an option in the "Panel" macro that says "Show in Table of Contents"... that's all !!!

It is sometimes SO DIFFICULT to make a really good looking and organized page in confluence that I wonder whether you guys really want to make it hard for us

Like Scott DeLugan likes this

Agreed. TOCs should be able to link to headings within panels, especially if the TOC recognizes them as links.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

738 views 5 21
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you