Skip to content
notionsolutions

A practical library for building,
organizing and working in Notion.

Workflow guides

Notion Table of Contents: Add, Place and Fix Missing Headings

Notion has two tables of contents: a block you add with /toc and an outline on the right that shows once a page has two headings. Here's how to add and place the block, color it, turn the outline off, fix missing headings and list only the sections you choose.

Published
White ceramic tiles stepped like an indented outline on a brushed steel tray, an electric-blue glass marker on one tile, and the headline Every Heading, One Click Away
The block lists your page's headings and jumps to each one when you click it.

A Notion table of contents comes in two forms: a block you add with /toc, and an outline on the right that Notion shows by default once a page has two or more headings. The block lists your headings, indents H2s and H3s, and jumps to one on click. I'd add the block to any page a client or teammate reads, because it shows the full list without a hover. Keep the outline for your own long pages, or turn it off under ••• → Appearance & layout.

For a page clients or teammates open from a link, choose the block. For your own working notes, keep the outline and skip the block. For a list of only some sections, neither form lets you pick headings, so build a short list of block links instead.

Table of contents block or page outline: which one do you need?

Notion's help on headings and the table of contents names two places a table of contents can appear: at the top of your page as a block, or at the right side of the page as you scroll, as a page-level setting. Both build their list from your headings, and both jump to a section when you pick it. The right-side version arrived in Notion's June 2024 release notes as a “floating” table of contents.

Table of contents block vs page-level outline in Notion
What you need to knowTable of contents blockPage-level outline
Where it showsWherever you place the block, usually the top of the pageThe right side of the page, following you as you scroll
How you get itAdd it with /toc, the slash menu or the + in the left marginShown by default once the page has two or more headings
What readers seeThe full list of headings, with H2s and H3s indentedA collapsed outline that expands to all headings when you hover over it
How to remove itDelete the block; it moves and deletes as one unit••• → Appearance & layout, then turn off Table of contents for that page
Best forPages other people read: client briefs, SOPs, wiki articles, published pagesLong pages you work in yourself

The outline needs no setup and stays out of the way until someone hovers over it. That's the reason I don't count on it for a reader who opens a page once: the full list only appears on hover. On a wiki home page, the Appearance & layout menu doesn't show the Table of contents switch at all, so the block is the way to give that page a table of contents you control.

Native Client brief page with an in-page table of contents linking to Overview, Deliverables and Timeline headings
The in-page block lists the page headings. Edit a heading on the page to change its wording in the list.

How do you add a table of contents in Notion?

Start with headings, because the block lists nothing else. Type /h1, /h2 or /h3 and press enter, or type #, ## or ### followed by a space at the start of a line. For a line you've already written, press cmd/ctrl + / and choose a heading size. Then add the block:

  1. Click an empty line where the list should go. For most documents that's near the top, under a sentence that says what the page is for.
  2. Type /toc and select Table of contents in the menu. Typing /table of contents finds the same block. You can also hover over a new line, click the + in the left margin and pick Table of contents.
  3. Click a line in the new list to check that it jumps to the right heading.

Notion's shortcut reference lists /toc as the slash command for this block. The block works as a single unit: you move, delete, duplicate and color it as a whole with the ⋮⋮ handle that appears when you hover over it. You can't type inside it. To change a line's wording, edit the heading on the page and the list shows the new text. For the heading keys on Mac and Windows, our Notion shortcuts guide has the full set.

Native Notion slash-command menu with Table of contents selected under Table and Table view, and /table typed on the page
Choose Table of contents in the slash menu. The /toc shortcut creates the same block.

What shows up in a Notion table of contents?

The rules below decide what the list includes and what it leaves out. Each row follows Notion's help, with the fix next to it.

What shows up in a Notion table of contents
Content on the pageIn the table of contents?What to do
Heading 1, 2 and 3 blocksListed; H2s and H3s are indented to show the page's structureNothing; click a line to jump to its heading
A heading indented under another blockNot listedClick into it and press shift + tab to un-nest it
The title of an inline database or tableNot listed, even when you've named itAdd a heading directly above the database
Bold text used as a section titleNot listed; it isn't a heading blockPut the cursor in the line, press cmd/ctrl + / and choose a heading size
A heading's colorNot shown; the whole list is one colorColor the table of contents itself
The wording of a lineShown as the heading reads; not editable inside the blockEdit the heading on the page

One practical consequence of the heading rule: if you label the block with a line such as “On this page”, make that label bold text rather than a heading, or the label turns up in the list itself.

Where should the table of contents go on the page?

Notion's help puts the block at the top of the page, and that's where I'd start on almost every document. Readers see the sections before the first one begins, and anyone sent a link to the page lands on a map of it. Two other placements come up often.

In a column beside the content

Drag the block by its ⋮⋮ handle to the side of your text and drop it when the blue guide appears. That creates a column, and dragging the gray guide on the shared edge resizes it. Two things change. The list scrolls away with the page: Super's guide to the block notes that a sidebar built from Notion columns won't be sticky, while the right-side outline is the version that follows you. And Notion's own help on columns says they aren't available on phones, where content in a right-hand column is placed under the content on the left.

So a table of contents in a right-hand column ends up below the page's content on a phone, which is the opposite of what a reader needs there. If you build a sidebar, I'd put the table of contents in the left column so phone readers still get it first.

Inside a toggle

Site-builder guides from Bullet and Super both suggest a collapsible version: type /toggle (or > and a space), name the toggle “Table of contents”, then drag the block inside it. It saves room on a long page, but readers see only the toggle's title until they click it, and Notion has no setting that makes a toggle start open. I'd keep the list visible on client pages for that reason and save the toggle for internal pages where the list runs long. How toggles open, close and hold nested content is covered in our Notion toggle guide.

How do you change the table of contents color?

The whole list takes one color, and coloring a heading on the page doesn't carry over to it. To change it:

  1. Hover over the table of contents and click the ⋮⋮ handle. Or select the block and press cmd/ctrl + /, or right-click it.
  2. Choose Color in the menu.
  3. Pick a text color or a highlight. Either one applies to every line in the list.

I'd leave the default color unless the list sits next to other lists. In that case, pick one color the page uses nowhere else, so readers see the block as the page's navigation and not as another list of notes.

Native expanded Notion floating table of contents at the right edge, with Introduction through Conclusion entries
Hover over the right-side outline to expand the heading list. This navigation belongs to the page layout, separate from the in-page block.

Why is a heading missing from the table of contents?

Check these in order.

If the right-side outline is the one missing, check the count and the switch. It needs two or more headings to show by default, and someone may have turned it off for that page under ••• → Appearance & layout. On a wiki home page the switch isn't there, so use the block.

Can a table of contents show only some headings?

Not through a setting. The block builds its list from the page's headings and you can't edit its contents directly, so there's no checkbox to leave one out. Two workarounds stay inside Notion's documented behavior.

Keep one heading out by indenting it

Click into the heading and press tab. It nests inside the block above and drops out of the table of contents block, because indented headings aren't listed. The block above it has to be one that can hold nested content, such as a text line, a list item or a toggle: in Notion's block reference, a heading can hold nested blocks only when it's a toggle heading. The cost is visible. The heading shifts right on the page, and selecting the block above it now selects the heading too. I'd use this for one or two minor subheadings, not for a whole level of the page.

Build a list of only the sections you choose

  1. Hover over a heading you want in the list, click ⋮⋮ and select Copy link to block.
  2. At the top of the page, type the section's name as a list item, select that text and press cmd/ctrl + V to paste the link over it.
  3. Repeat for each section you want listed.

Notion's help on links and backlinks says every block has its own anchor link, so each item takes the reader to its section. The wording is yours, which also means you rename the item when you rename the heading. I'd choose this list for a client-facing page with many small subheadings, where only the main sections belong at the top.

Does a table of contents work on wikis and published sites?

Yes, with one difference for each. Wiki home pages don't offer the page-level switch in Appearance & layout, so add the block if the wiki's front page needs a table of contents. Our company wiki guide covers the structure, owners and permissions behind the rest of the wiki.

On a page published to the web, Notion's help on public pages and Notion Sites answers the question of linking to one section: a table of contents in your public page creates anchor links to its headings. Edits carry over as well, since a published page updates the site automatically as you change it, so a renamed heading reaches the public list without republishing. Publishing, site settings and custom domains are in our Notion website guide.

If your site runs through Super, its floating table of contents is Super's own feature, switched on for the whole site under Settings → Look & navigation in the Super Dashboard. Super's documentation says a page needs at least two heading blocks for it to appear.

How is the table of contents stored in the API?

If you create pages through Notion's API, the table of contents is a block of type table_of_contents, and the block reference example holds a single field, color, with no list of entries. That matches the editor: the list comes from the page's headings, so to fill it, add heading blocks such as heading_1, heading_2 and heading_3. Notion's developer changelog also records a newer heading_4 block type, while the help pages for the table of contents describe three heading levels, so check how a fourth-level heading appears in the list before you build a template around it. The request itself is covered in our guide to creating a page with the Notion API.

My pick: the block at the top, the outline for everything else

For any page another person will read, add the block with /toc under the page's opening line, keep its color plain unless it sits beside other lists, and move it into a left column only if you need a sidebar. Leave the right-side outline on for your own long pages. The block lists the headings; deciding which sections deserve a heading is still your call, and that decision is what makes the list worth reading.

Your first step: open the longest page you share with a client, type /toc under its first paragraph and read the list. Any section that's missing or misnamed is a heading to fix on the page.

Help readers find their way