Lifestyle

WordPress tables of contents: heading structure, anchors, and mobile reading

A table of contents can help readers find the right section in a long WordPress article, but its headings and jump targets need care. This guide covers manual anchors and Easy Table of Contents settings, fixed headers that obscure headings, mobile navigation, repeated headings, and checks after editing an article. The aim is useful reading navigation, not merely another box above the text.

About 6 min read

Share on LINE
Original document and screen illustration showing how article sections become a table of contents with jump links.
Image: Mokaair (© Mokaair)
Contents
  1. 1. Make section names answer readers' questions
  2. 2. For a few key sections, start with manual anchors
  3. 3. Generate a table with Easy Table of Contents
  4. 4. Remove noise and keep the table readable
  5. 5. Check sticky tables and fixed headers together
  6. 6. Add table checks to the editing workflow

Someone opening a site-migration tutorial may only want the section on URL redirects. Even a thorough article is hard to use if they must scroll endlessly. A table of contents lets readers see the scope first and jump to the place they need; it should reflect the logic of the article.

Using a long article with preparation, steps, checks, and FAQs as an example, this guide explains WordPress anchors and Easy Table of Contents. Clarify the sections first, then choose automatic generation or manual upkeep, and finally check the result on desktop and mobile.

Make section names answer readers' questions

Read all the subheadings on their own. A sequence such as Introduction, More Introduction, and Other Matters tells readers little. Try specific questions instead: What do I need before starting? How do I move the files? How do I check the site afterward? A table of contents should show the main reading path, not list every sentence.

Use real Heading blocks in the editor, with H2 and H3 levels matching the content hierarchy. Do not merely enlarge and bold normal paragraphs, or jump between levels to change their size. Use H2 for major steps and H3 for details within a step; let theme styles control visual size.

Give repeated FAQs or cautions a subject, such as Precautions before moving files and Precautions when changing URLs. Readers can then tell where they are when moving between the table and body. Editors and support staff can also reference a specific section later.

For a few key sections, start with manual anchors

In a Heading block's Advanced settings, enter an HTML Anchor such as prepare-files. Then add a #prepare-files link to a list or button near the start of the article to jump to that section. A link from another article uses the full page URL followed by the same fragment.

WordPress advises that anchors must be unique within a document, are case-sensitive, and cannot contain spaces. For sections likely to be linked over time, choose a short, clear name and keep it in editorial records. Changing the visible heading does not always require changing an anchor others already use.

Manual anchors work well on service pages or features with few, stable sections. When sections are added or removed, however, you must update the table yourself. Do not forget the list after creating it: click every item during review and check for missing destinations or the wrong section with a repeated name.

Generate a table with Easy Table of Contents

After enabling Easy Table of Contents, first choose which content types it supports, then choose which should receive an automatically inserted table. Support and auto-insertion are separate settings. To start, you might select ordinary posts only so a home page, checkout page, or short announcement does not acquire an unwanted table.

Choose a position and display threshold to suit the article, such as showing a table only when enough sections exist. Placing it after a short introduction lets readers first learn what the article solves. Set a clear label and heading levels; major sections and necessary subsections are usually enough, without listing every H1 through H6.

  1. Enable the content types you need and test auto-insertion on a representative long article.
  2. Set the position, display conditions, and included heading levels.
  3. Check whether the theme or another plugin already generates a table, so the page does not show two.

Remove noise and keep the table readable

If related posts, footer, or ad headings appear in the table, investigate why those blocks are counted as article content. The plugin offers heading-exclusion settings. Its documentation lists exclusion by CSS class as a Pro feature, so check the edition before depending on that option.

Some page builders or shortcodes produce headings dynamically. The editor preview may therefore look right while the public table differs. Test the actual published layout, not only the editor sidebar. Recheck representative pages after plugin updates, especially repeated headings, collapsible content, and dynamic blocks.

Do not make the table text too small. Let long headings wrap, keep indentation understandable, and consider showing main sections first or offering an obvious expand control for a very long article. Readers must recognize that the table is interactive; collapsing it by default should not hide its purpose.

Check sticky tables and fixed headers together

Easy Table of Contents lists Fixed/Sticky TOC as a Pro feature. Before choosing a persistent table, decide whether readers really need it while scrolling. Space for a desktop sidebar does not mean a full list belongs in the corner of a phone screen; contact buttons, Cookie notices, and back-to-top controls may compete for that space.

If a fixed header covers a section heading after a jump, adjust the offset. First check whether the plugin or theme has a relevant setting. When custom CSS is needed, a maintainer can consider scroll-margin-top and verify it against the header's actual height. Do not assume one numeric value works on every device.

Smooth scrolling is a visual effect, not a substitute for reaching the right target. Test long pages and slower devices, and watch whether images loading afterward shift the destination. If animation makes reading harder, simplify it while retaining clear links and stable section positions.

Add table checks to the editing workflow

Before publication, click the first, middle, and last entries, then test every item. Use a keyboard to operate expansion controls and links and make sure focus is visible. On narrow screens, check for overflow and covered body text; rotate a phone and inspect fixed elements again.

Share a URL with an anchor fragment into a fresh signed-out window and confirm it opens at the intended section. If images or ads change page height after loading, pay particular attention to deep links opened directly. This differs from clicking the table after the page has fully loaded; keep both tests.

When updating an article, check whether a referenced section was removed, renamed, or moved, then update the table. If an anchor must change, repair related internal and support links so they do not open the page without finding the section. Maintaining the table with the content keeps saving readers time.

Original four-panel diagram showing how to organize sections, configure the table, verify jump positions, and test on a phone.
A table improves long-form reading only when readers can understand it, use it, and reach the right section. · Image: Mokaair (© Mokaair)
Choose a table style for readers' needs, then test where links actually land.
MethodSuitable contentOngoing work
Manual anchors and listA few stable sectionsUpdate links when sections change
Automatic table of contentsLong articles edited oftenCheck heading levels, exclusions, and duplicate tables
Sticky tableReading that requires repeated jumpsCheck paid features and screen obstructions

Found this guide helpful? Share it with someone who needs it

Share on LINE
  • Lifestyle

    Before Resetting WordPress: Separate Content, Theme Settings, and Full Restore

    Starting over in WordPress does not always require wiping the site. This guide compares style resets, content revisions, database resets, and full restores; explains the scope of WP Reset and the limits of its snapshots; and walks through a test site, backup checks, and acceptance after a reset. It helps ordinary users in Taiwan identify the actual problem and choose a suitably narrow action with a recovery plan.

  • Lifestyle

    WordPress Performance Plugins: Caching, Images, and Feature Conflicts

    WordPress performance plugins need settings matched to the actual site; enabling every option at once is unsafe. Using a small Taiwan-based course and shop site, this guide compares WP Rocket and NitroPack, divides responsibility for caching and images, and shows how to diagnose conflicts caused by CSS and JavaScript optimization. A comparison table, staged workflow, and original diagram help administrators retain a measurement baseline and verify forms, menus, and shopping flows.

  • Lifestyle

    Handling WordPress Comment Spam: Review Rules and Akismet

    Stopping spam in WordPress comments takes sensible moderation rules and a way to correct mistakes, as well as a plugin. This guide covers discussion settings, Akismet activation and plan eligibility, reporting spam, and rescuing legitimate comments. Its daily review checklist helps small-site owners reduce the workload while leaving room for readers with real questions to join the discussion.

  • Lifestyle

    Build a personal blog with WordPress: from categories to your first post

    To start a personal blog, decide what questions you want to answer over time, then plan the homepage, post list and basic pages. Using WordPress as an example, this guide develops a writing workflow from content categories and reading layouts through the first post and later updates. It also covers checks for post cards, pagination and comments. It is for readers in Taiwan who want to turn their notes into public content: finish a small but complete site first, then add features as needed.

Sources

Compiled from the references and verification dates listed above; fares, schedules, product features, and terms can change, so please confirm the latest details on the relevant official website before travelling, booking, or purchasing.

Lifestyle