Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

This question is in reference to Atlassian Documentation: Table of Contents Macro


As explained in the Table of Contents Macro documentation, I tried to configure a TOC in the sidebar using this :


It creates a great TOC but when I want to access a link of this TOC, I get a "page not found" error...

I'm using Confluence 5.10.1

5 answers

1 accepted

0 votes
Answer accepted


This issue has been recognised and accepted by Atlassian team : it is tracked by the ticket CONF-43090

Thanks to all for your concern and your answers

This process used to work for me, but now doesn't. I didn't notice if it was at a particular version upgrade. We're on 6.6.1 now.

On the page itself, I have anchors for every section, and then added references to each anchor in the sidebar (Space tools > Look and Feel > Sidebar, header and footer). In the Sidebar, I used this format:


and so on. Now that I think about it, it seems insufficient because there's no page name (there's only one page in this space), but this used to work to jump to a specific spot on the page. Now I get a Page Not Found error.

Putting it in the sidebar makes no real sense to me.  The side bar is for navigating TO a page.

The TOC macro is supposed to be put in the main body of the page as it is only relevant to THAT page, i.e. for jumping to headings within the page.


Thanks for your answer. I understand your point of view but it's not mine : I found no easy way to have an always visible TOC whatever the position in the page. The easiest way I found is to put it in the sidebar.

Moreover, as it is described in a confluence documentation page (, it seems not that ridiculous to me to use it as it is described.

Like Eugene Rosenfeld likes this

Well, what I am saying is I don't think the functionality of the TOC macro would work properly in the side pane as it is intended as an "on page" thing - if you try to use a screwdriver as a hammer you end up with difficulties because you are using the wrong tool

What you might want to investigate is putting the TOC macro into the page header and then make that the default or selectable page template (I have a standard header and footer in my pages ) ... but obviously that would make the header gets bigger and bigger as more and more headings are added in the page... so you could put an Expand macro in the header and put the TOC inside the Expand so it normally looks like a single line :smile:

Thanks a lot for your quick answer.

The problem with the TOC macro into the page header is that when the page is scrolled, the TOC disapear, when the sidebar is still available.

The thing is that we use Confluence to create technical docs (like specification docs). Thus, pages can be very long and we really need to have a TOC always available...

Are you telling me that there is no way to make toc macro work in the sidebar ?

Like Eugene Rosenfeld likes this

Our Industry Association also uses Confluence for drafting long reference documents.  The TOC of course only works in view mode.  But you can also add an Anchor at the top of the TOC and then in each section heading, include a link back to the Anchor - still not perfect but does help

I am not saying "definitively" - but it seems counter intuitive to the way the side pane works.

I suspect there may be some way to "lock" the header from scrolling but you may need to be a full on Administrator - check their version of documentation for configuring the Space appearance

Struggling with the same issue now that we upgraded to 6.3.4.  The TOC has to use ABSOLUTE links, which when placed in the sidebar, forces a full reload of the page every time you click on any of the links which should just be "bookmark" type links?

Hi Nate .... it seems TOC in sidebar just doesn't work ..

Eric Foucher posted a link on 23 Jan 2017 above to the issue register where you can vote for a fix ... although in my experience that process doesn't guarantee any fix any time soon ....  with only a handful of votes I dare say don't expect anything for several years!!!

If you look I posted and voted there as well.  So many annoying little things in confluence when all you really want is direct access to the code to do it right! :)

Like Rufus Casey likes this

If you wish to have a floating TOC (that scrolls with the page) you can use a CSS class to define it.

First define the CSS in Space Tools > Look and Feel > Stylesheet and then cite it in the TOC macro in the sections "CSS Class Name".

Like in these answers

Here is a floating TOC free plugin you can use (for server).

Suggest an answer

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

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

402 views 23 8
Join discussion

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