How to add a table of contents in Confluence Cloud

How to add a Confluence table of contents

1. Go to edit mode and type in the keyboard shortcut /table of contents. Choose the "Table of contents" macro in the dropdown.
   
   
2. In the sidebar, use the Basic tab to customise the look of your table of contents and which heading levels to display.
   
   
3. In the Advanced tab (optional), configure more advanced options, such as excluding specific headings.
   
   
4. Press Publish or Update on your page to share your new table of contents.

How to customise your Confluence table of contents

Basic customisation

• Under Display as, select whether you want your list of contents to appear vertically or horizontally.
  
  
• Under Bullet style, choose whether items on your list are separated by square brackets, bullet points, numbers, and more.

• Choose which level of headings (e.g. only Heading 2 to Heading 3) you want to appear in your table of contents.
  
  
• Toggle to include section numbers in addition to bullet points (see below for an example).

Advanced customisation

• Indent the headings that show within your table of contents. For this, you’ll need to enter a valid CSS value.
  
  
• Filter to include or exclude headings containing certain words, phrases, or numbers. Make sure to separate different expressions that you want to filter by typing a comma between each.

• If you want to use custom styling for your table of contents, you can assign a CSS class name that is referenced in your CSS style sheet.
  
  
• Select whether or not to allow your table of contents to be exported as a PDF.

Reasons to add a table of contents to your Confluence page

• Improve navigation: Users can easily find relevant information without scrolling through the entire page, which saves time and effort.
  
  
• Ensure accessibility: A table of contents can improve accessibility for users who rely on screen readers or have other accessibility needs, allowing them to navigate the content more efficiently.
  
  
• Enhance documentation and knowledge management: In Confluence, a table of contents serves as a roadmap for documenting and organising information, making it easier to maintain and update content over time.
  
  
• Improve searchability: Including a table of contents with relevant keywords and links can improve the page's visibility and structure, helping users find content more easily.