Docs
← Back to site

Table of Contents (auto-generated)

2 min readUpdated November 21, 2026

WP Super Docs builds a table of contents automatically from the headings in your doc, no manual list to maintain.

How it works#

Every H2 and H3 heading in your doc’s content is picked up automatically and listed in a sticky sidebar titled “On this page.” As the reader scrolls, the link for whichever section is currently in view is highlighted, so they always know where they are in a long doc.

The "On this page" table of contents beside a doc.

There’s nothing to set up per doc. Just structure your content with headings, and the table of contents follows automatically.

When it appears#

The table of contents only shows up when a doc has at least two H2 or H3 headings. A doc with zero or one heading doesn’t get one, since a table of contents for a single section isn’t useful.

H1 and headings below H3 (H4, H5, H6) aren’t included, so keep your main sections at H2 and subsections at H3 if you want them to appear.

Turning it off#

The table of contents is on by default. To turn it off sitewide, turn it off under Settings → Setup → Content.

The Doc page features settings: reading time, last updated, table of contents, related docs, sharing and feedback.

Hovering over a heading in your doc reveals a small # link next to it. Clicking it copies a direct link to that section, so readers can share or bookmark a specific part of a long doc rather than the whole page.

A doc page with the table of contents on the right.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only