> ## Content Index
> Fetch the complete content index at: https://notionsolutions.net/llms.txt
> Use this file to discover other available public pages before exploring further.

# Notion Table of Contents: Add, Place and Fix Missing Headings
- URL: https://notionsolutions.net/notion-table-of-contents/
- Published: 2026-11-10T09:00:00.000Z
- Updated: 2026-11-21T02:39:28.000Z
- Description: 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.
- Author: Kevin Turner
- Tags: guide

**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](https://www.notion.com/help/columns-headings-and-dividers?ref=notionsolutions.net) 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](https://www.notion.com/releases/2024-06-11?ref=notionsolutions.net) as a “floating” table of contents.

__Table of contents block vs page-level outline in Notion__
| What you need to know | Table of contents block                                                      | Page-level outline                                                                   |
| --------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Where it shows        | Wherever you place the block, usually the top of the page                    | The right side of the page, following you as you scroll                              |
| How you get it        | Add it with /toc, the slash menu or the **+** in the left margin             | Shown by default once the page has two or more headings                              |
| What readers see      | The full list of headings, with H2s and H3s indented                         | A collapsed outline that expands to all headings when you hover over it              |
| How to remove it      | Delete the block; it moves and deletes as one unit                           | **•••** → **Appearance & layout**, then turn off **Table of contents** for that page |
| Best for              | Pages other people read: client briefs, SOPs, wiki articles, published pages | Long 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](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-block-and-headings-20261121.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-block-and-headings-20261121.webp?ref=notionsolutions.net)

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](https://www.notion.com/help/keyboard-shortcuts?ref=notionsolutions.net) 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](https://notionsolutions.net/notion-keyboard-shortcuts/) 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](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-slash-menu-20261121.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-slash-menu-20261121.webp?ref=notionsolutions.net)

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 page                      | In the table of contents?                                     | What to do                                                                   |
| ---------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Heading 1, 2 and 3 blocks                | Listed; H2s and H3s are indented to show the page's structure | Nothing; click a line to jump to its heading                                 |
| A heading indented under another block   | Not listed                                                    | Click into it and press **shift + tab** to un-nest it                        |
| The title of an inline database or table | Not listed, even when you've named it                         | Add a heading directly above the database                                    |
| Bold text used as a section title        | Not listed; it isn't a heading block                          | Put the cursor in the line, press **cmd/ctrl + /** and choose a heading size |
| A heading's color                        | Not shown; the whole list is one color                        | Color the table of contents itself                                           |
| The wording of a line                    | Shown as the heading reads; not editable inside the block     | Edit 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](https://super.so/blog/how-to-add-a-table-of-contents-in-notion?ref=notionsolutions.net) 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](https://bullet.so/blog/how-to-add-a-table-of-contents-in-notion/?ref=notionsolutions.net) 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](https://notionsolutions.net/notion-toggle/).

## 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](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-floating-outline-20261121.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-table-of-contents-native-floating-outline-20261121.webp?ref=notionsolutions.net)

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.

- **The heading is indented.** Pressing tab nests a block inside the one above it, and Notion's help says [indented headings aren't included in a table of contents](https://www.notion.com/help/columns-headings-and-dividers?ref=notionsolutions.net). Click into the heading and press **shift + tab** to un-nest it. A heading typed inside a toggle list sits indented under that toggle too, so going by the same rule it stays out. Move it out of the toggle, or make the section a toggle heading, which is still a heading.
- **It's a database title.** The name of an inline database or table doesn't appear, even when you've named it. Add a heading directly above the database.
- **It isn't a heading block.** Bold text that looks like a section title doesn't count. Put the cursor in the line, press **cmd/ctrl + /** and choose a heading size.
- **It sits inside a column or a synced block.** Drag the heading out to the page's main level and check the list again. That tells you in one move whether the container is the cause.

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](https://developers.notion.com/reference/block?ref=notionsolutions.net), 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](https://www.notion.com/help/create-links-and-backlinks?ref=notionsolutions.net) 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](https://notionsolutions.net/notion-company-wiki/) 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](https://www.notion.com/help/public-pages-and-web-publishing?ref=notionsolutions.net) 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](https://notionsolutions.net/notion-website/).

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](https://docs.super.so/notion-floating-table-of-contents?ref=notionsolutions.net) 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](https://developers.notion.com/page/changelog?ref=notionsolutions.net) 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](https://notionsolutions.net/notion-api-create-page/).

## 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.