A table of contents helps readers jump to the part of a long page that answers their question. Build the article’s headings first, then add the contents block and verify its destinations. A list of links is useful only when its labels and the page sections remain in agreement.
Organize the page before adding navigation
Write a logical hierarchy of headings and place related paragraphs beneath them. Each main section should have a descriptive label. Do not add a table of contents to compensate for a page whose sections are duplicates or whose headings only say introduction, more and conclusion.
Insert the contents block near the beginning
Search for Table of Contents in the Gutenberg inserter. Review its available heading and display controls in your installation. Place it where readers can decide which section they need without making them scroll through a large promotional introduction first.
Check labels and anchor destinations
Open the frontend and follow every generated or configured entry. Confirm that it reaches the intended heading. Repeated headings, imported anchors and later structural edits can create confusing destinations, so do not rely only on the appearance of the contents list inside the editor.
Allow room around the landing point
If a sticky header covers a heading after a jump, review the page’s anchor offset or layout behavior. Keep enough context visible to show that navigation succeeded. Test the first, middle and last sections, because the final destination may have less space beneath it.
Review the article after editing
Check the list again whenever headings are renamed, removed or reordered. On a phone, verify that labels remain readable and any collapsed contents control is obvious. Add Reading Time only if it helps set expectations rather than distracting from the navigation task.
Before you finish
- Headings form a useful hierarchy.
- Every contents entry reaches the right section.
- Sticky navigation does not cover the target.
- The list is checked after structural edits.
Questions and answers
Does a short page need a table of contents?
Not necessarily. A short page may be easier to read directly, without an extra navigation component.
Will the contents list update after every edit?
Check the selected block’s behavior and the public result. Verify destinations after changing headings instead of assuming the list stayed correct.
Sources and scope
This guide uses Blockenberg’s documented editor workflows and block definitions available on November 1, 2026. Labels and provider availability can change. Test the result with your theme and plugins.
AI-assisted draft, checked against product sources. Examples are illustrative; they are not customer results or performance guarantees.