Easy Tech TutsHow to Add a Table of Contents in Confluence Easily 2026
By Impran M N
Long technical pages become hard to navigate without a clear outline. This guide shows how to add a self-updating table of contents to a Confluence page in 2026, so readers can jump straight to the section they need.
01Open the TOC macro
In edit mode, click your insertion point and type `/toc` or `/table of contents` to deploy the automated index block.
02Open macro settings
Click the inserted macro container to open the floating advanced options panel.
03Set heading depth
Configure the minimum and maximum heading levels you want the outline to track.
04Choose a display style
Select between bulleted lists or a flat index format, and exclude any terms you don't want listed.
05Verify your headings
Check the sidebar panel to confirm your document's heading hierarchy looks correct before publishing.
06Publish the page
Click Publish to make the dynamic table of contents live.
Frequently asked questions
Does the table of contents update automatically as I edit the page?
Yes, the TOC macro scans active heading levels in real time and updates itself as you edit text.
Can I limit the table of contents to certain heading levels?
Yes, the macro's depth controls let you isolate specific tiers, from Heading 1 down to detailed sub-headings.
Why do my table of contents links not jump to the right spot?
Broken jump links are usually fixed by structuring proper paragraph blocks around headings so the index snaps to the correct location.
Can I put the table of contents in a sidebar instead of the top of the page?
Yes, you can embed the outline inside a fixed right-hand panel or column wrapper for full-page scannability.
Watch the full walkthrough
The same steps, demonstrated on screen from start to finish.
