Floating Table of Contents for Confluence Documentation

Owned by Matthew Grover
Last updated: Jun 15, 2024
4 min read

Adding to a Page

  1. On a page where you want to have a Floating Table of Conents, start typing a “/” followed by the beginning of the word “floating”. You can add the Floating Table of Contents macro anywhere on a page.

  2. Click on the Floating Table of Contents box

  3. You will see the Floating Table of Contents Edit box appear

  4. (Optional) To configure the Floating Table of Contents macro see the Configuring the Floating Table of Contents section.

  5. Publish the page by pressing the Publish button in the top right of the page.

You will then be able to see a Floating Table of Contents on the right of your page content which will stay visible wherever you scroll on the page.

Caching

Due to Confluence caching, after making a change to the headings or width of a page, you may need to refresh the page after publishing a change before the Floating Table of Contents will display correctly and fully up to date.

Similarly, due to Confluence caching, If you make a change to the Floating Table of Contents Minimum Heading Level or Maximum Heading Level parameters, you may need to Publish the page, then edit it and Publish it again for the changes to the parameters to take effect.

Configuring the Floating Table of Contents

 

Include headers from Include and Excerpts

Unlike the built in Table of Contents Macro, the Floating Table of Contents macro allows you to include headers from pages that are visible on the page because they are included via the “Include Page” or “Excerpts” macro as if they were directly written onto the page. All you need to do to enable this behaviour is to tick the “Include headers from Include and Excerpts” box.

 

Display Section Numbering

Tick the Display Section Numbering box to have section numbers displayed next to the headings.

Here is an example with the box ticked and Display Section Numbering enabled:

And here is an example with the box not ticked and Display Section Numbering disabled:

 

Minimum and Maximum Heading Levels

You can configure the Minimum and Maximum Heading Level as you would with the built in Table of Contents macro. If you leave these values at their defaults then all Headings on the page will be displayed in the Floating Table of Contents.

The Minimum Heading Level setting is minimum heading level to display in the Floating Table of Contents. For example, '3' will list headings from 'h3.' (Heading 3) onwards, but not 'h1.' (Heading 1) or 'h2.' (Heading 2).

The Maximum Heading Level setting is maximum heading level to display in the Floating Table of Contents. For example, '4' will list headings up to 'h4.' (Heading 4), but not from 'h5.' (Heading 5) onwards.

Page Width

The Floating Table of Contents will only display when there is enough room to display the table of contents alongside the page content without obscuring it. When viewing a Confluence page with the content set to fill the full page width, then you may need a very wide browser window to see the Floating Table of Contents

Hiding

If you do not want to see the Floating Table of Contents when browsing a page, for example if you are browsing on a device with a very thin width, then you can press the X button to hide the Floating Table of Contents.

 

Expired License

If your license for the Floating Table of Contents macro expires or is cancelled you will see the following instead of the Floating Table of Contents.