You can use the Table of Contents block to quickly create a table of contents based on all the headings on a page. It gives your readers an overview of your content and links to click to navigate directly to that section.
In this guide
To add the Table of Contents block, click on the + Block Inserter icon and search for “table of contents”. Click to add the block to a page or post.
For more information, visit our detailed instructions on adding blocks.
The Table of Contents block automatically creates links out of all the Heading blocks on the page. It uses HTML anchors so that readers can click on any item in the table of contents to jump directly to the section of the page with that heading.
💡
The Table of Contents block uses all headings on the page. If you prefer to pick and choose which items to include in a table of contents, you can use page jumps to manually create a table of contents instead.
If you insert the Table of Contents block but don’t yet have any Heading blocks within your content, you’ll be given a prompt to start adding Heading blocks to create a table of contents.
Headings are ranked by importance or level. The highest level of heading is H1 and the lowest is H6. Ideally, your first Heading block on the page will be set to H2 (since the page’s title is set to H1.) Learn more about heading levels.
If you start with an H2 heading and then add an H3 to H6 below it, these will get incrementally nested and added as sub-headings within the Table of Contents block as illustrated below:
If you reverse this order and start with an H6 then add an H2 below it, the H2 won’t appear in the Table of Contents block at all.
When you click on the block, a toolbar of options will appear above or below it:
The Table of Contents block has the following options in its toolbar, from left to right:
- Transform the Table of Contents block to another type of block.
- Drag the block to change its position.
- Move the block up or down.
- Convert the table of contents to a List block.
- More options.
When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:
On pages or posts that include pagination or page breaks, this setting allows you to either include headings from the current page only or include headings from all pages.
For more, visit our detailed instructions on Advanced settings.
In the block settings sidebar, click on the Styles icon to access the design settings for the block. The Styles icon is in the shape of a circle with half of the circle filled in:
The Table of Contents block includes the following settings to adjust the appearance of all the text in that block:
