What is a table of contents block in Notion?

A Notion table of contents block is a dynamic navigational tool that automatically generates a clickable outline of your page's headings, transforming long documents into easily navigable resources. This powerful block scans your entire page for Heading 1, Heading 2, and Heading 3 blocks, then displays them in a hierarchical, indented structure that updates in real-time as you modify your content. When you click any entry in the table of contents, it instantly jumps to the corresponding section, making document navigation remarkably efficient for both creators and readers.

Creating a table of contents block couldn't be simpler—just type `/table of contents` anywhere on your page or use the plus button to select it from the block menu. The block appears wherever you place it, functioning as a single unit that can be moved, duplicated, or deleted as needed. What makes this feature particularly valuable is its automatic nature: you don't need to manually update links or reorganize entries when you add new sections or change existing headings.

The block excels in various scenarios, from wikis and knowledge bases to project plans and long-form content. Teams use it to quickly locate project milestones, while content creators leverage it to enhance reader experience and improve document accessibility. The hierarchical display visually represents your content structure, making complex information feel more organized and approachable.

However, the table of contents block does have some limitations worth considering. Customization options are minimal—you can't selectively exclude specific headings without changing their block type, nor can you significantly alter the visual appearance. The block only recognizes official Notion heading blocks, so text formatted to look like headings within toggles or callouts won't appear in your table of contents.

Despite these constraints, the table of contents block remains an invaluable tool for anyone creating substantial content in Notion. Its seamless integration with collaboration features means multiple users can interact with it simultaneously, and it respects your page's sharing permissions. For documents with multiple sections or complex information hierarchies, this block transforms the reading experience from a linear scroll into an interactive journey through your ideas.