CATEGORIES 

How to Add a Table of Contents to Your Blog

Advice Hub

Josh discussing adding a Table of Contents to your Blog

(And Why You Should)

You’re looking at a table of contents right now. It’s at the top of this post, it links to every major section, and if you’re only here for the Showit walkthrough you can jump straight to it without reading any of this.

That’s the whole point.

When we audit content programs for new clients — and we do a lot of content audits — the absence of a TOC on long-form posts is one of the most consistent, easily fixable gaps we find. It’s not a big technical lift. It’s not expensive. And it changes how both readers and search engines experience the page. We add one to everything we publish, including this post, which is why bringing it up doesn’t feel like a stretch. It’s also here because “jump to” links can appear in Google search results when anchor links are set up correctly — and we’d rather be the firm that explains how.

Why Tables of Contents Matter

Most readers of long-form blog content are not going to read every word. They’re going to scan the headline, skim the subheadings, and either jump to what they need or leave.

Without a TOC, the reader who wants section four has to scroll through sections one, two, and three to find it. That’s friction. Friction causes bounces. And bounces represent wasted effort on content you worked to create.

A TOC solves this immediately. It surfaces the structure of the post, signals depth of coverage, and invites the reader to navigate rather than scroll. For someone doing research — comparing options, following instructions, figuring out whether this post will actually help them — it’s the first thing they use.

When to use one: any post over roughly 1,000 words with three or more distinct sections. Short posts, landing pages, and sales pages don’t need them. A TOC on a 400-word post with two headings is just visual noise.

The SEO Case — It’s More Interesting Than You Might Think

Jump-to Links in Google Search Results

When Google shows a search result, it sometimes displays supplementary “jump to” links beneath the main result — quick links to specific sections of the page. These are pulled from the anchor links your TOC creates.

Earning jump-to links expands the real estate your result occupies, signals to searchers exactly what your content covers, and drives more qualified clicks. Not every post earns them — Google makes that call — but having anchor links correctly implemented is the prerequisite. You can’t get them if the structure isn’t there.

Featured Snippet Eligibility

Featured snippets — the highlighted answer blocks at the top of search results — are frequently extracted from specific, clearly delineated sections of long-form posts. Clean headings with anchor IDs make it easier for Google to identify and pull the relevant passage. How-to posts, definition posts, FAQ content, and technical guides are the most eligible formats. Which is exactly what the Advice Hub is built to be.

Structure Signal

Anchor-linked headings tell search engines what topics a page covers and how they connect. A post with a clear TOC is easier to parse than an undivided wall of text — which helps Google understand the full topical depth of the content and which searches it should appear for.

Linkable Section URLs

Every anchor link creates a shareable URL fragment: yourdomain.com/post/#section-name. That means you can link internally to a specific section of a long post, other sites can cite exactly the relevant passage, and you can share a direct link to the part that actually matters rather than dropping the full URL and hoping someone scrolls.

Plugin Options for WordPress

Four worth knowing about:

Easy Table of Contents — the most widely used standalone TOC plugin. Free, highly customizable, works with both classic and Gutenberg editors. Automatic insertion with per-post override. This is what we use and recommend for most sites.

LuckyWP Table of Contents — free, lightweight, Gutenberg-native. Good choice if you prefer block-based editing and want a simpler setup.

Table of Contents Plus — a veteran free plugin, well-tested, less visual customization than Easy TOC but reliable.

Rank Math — if you’re already using Rank Math as your SEO plugin, its built-in TOC block handles this natively in Gutenberg. One fewer plugin to manage, which is always worth something.

Yoast SEO does not include a TOC feature. If you use Yoast, pair it with Easy Table of Contents — they’re fully compatible.

How to Add a TOC: Easy Table of Contents

Install: Plugins → Add New → search “Easy Table of Contents” → Install and Activate.

Configure globally at Settings → Table of Contents. The settings that matter most:

Enable Support For: Select Posts (and any other content types you want TOCs on). Skip Pages unless you regularly publish long structured content there.

Auto Insert: On by default — turns on automatic TOC insertion across all selected post types. Leave it on unless you want manual control over each post individually.

Show when: Set a minimum heading count before the TOC appears. We typically set this to 3 or 4. This prevents the plugin from generating a TOC on short posts with minimal structure.

Heading Levels: H2 and H3 is the right setting for most blogs. Including H4 and below produces an unwieldy nested list that defeats the navigability purpose.

Position: Before First Heading is the standard placement and what we use.

Per-post control: Every post has an Easy TOC meta box at the bottom of the editor. Use this to exclude specific headings, override the global settings, or disable the TOC on a particular post without touching the global configuration.

Styling: Easy TOC ships with preset visual styles and supports custom CSS. The defaults work fine functionally — adjust to match your brand.

How to Add a TOC: Rank Math

If Rank Math is your SEO plugin, the workflow is simpler:

  1. Open the post in Gutenberg
  2. Add a new block, search “Table of Contents”
  3. Select the Rank Math TOC block
  4. The block scans your headings and populates automatically
  5. Exclude or rename individual entries as needed
  6. Place it near the top of the post, after the opening paragraph

The Rank Math TOC block updates in real time as you add or edit headings, which is the main reason to prefer it if you’re already in that ecosystem.

How to Add a TOC in Showit + WordPress

Showit uses an embedded WordPress blog. Your post content lives in WordPress; Showit handles the design layer. This means everything above applies — TOC plugins install and configure in WordPress admin exactly as described.

One thing to check: how the TOC renders on the live Showit front end. The plugin generates HTML with its own class names, and your Showit blog template may or may not style those classes. After setup, preview a post and confirm the TOC looks right. Minor CSS adjustments in Showit’s custom CSS settings usually handle any display issues.

Fixed header offset: If anchor links are landing slightly behind your fixed navigation header, add this to your WordPress custom CSS:

css

.ez-toc-anchor {

  scroll-margin-top: 80px;

}

Adjust the value to match your header height. This is a five-second fix and worth doing — nothing breaks the reader experience faster than clicking a jump link and landing in the wrong place.

Manual HTML Method

No plugin, no WordPress — this works for any CMS or custom-built site.

Step 1: Add id attributes to your headings:

html

<h2 id=”why-it-matters”>Why It Matters</h2>

<h2 id=”plugin-options”>Plugin Options</h2>

<h2 id=”common-mistakes”>Common Mistakes</h2>

Keep IDs lowercase, hyphenated, descriptive, and unique. #section-3 technically works. #common-mistakes is actually useful.

Step 2: Build the TOC as a linked list:

html

<nav class=”table-of-contents”>

  <p><strong>Quick Links:</strong></p>

  <ul>

    <li><a href=”#why-it-matters”>Why It Matters</a></li>

    <li><a href=”#plugin-options”>Plugin Options</a></li>

    <li><a href=”#common-mistakes”>Common Mistakes</a></li>

  </ul>

</nav>

Step 3: For fixed headers, apply a scroll-margin to your heading elements:

css

h2, h3 {

  scroll-margin-top: 80px;

}

The main downside of manual TOCs: if you restructure the post later, the TOC doesn’t update automatically. For posts you expect to revise regularly, a plugin is less maintenance.

Common Mistakes

Adding a TOC to short posts. A two-section post doesn’t need navigation. Configure Easy TOC to require a minimum heading count.

Including too many heading levels. H2 through H5 in one TOC is overwhelming. Stick to H2 and H3.

Burying the TOC. It should appear near the top of the post — after an opening paragraph at most. A TOC at the bottom of a long intro defeats the purpose.

Using TOCs on conversion pages. Landing pages and sales pages are designed to move readers through a sequence. Jump links let them skip to the end. Keep TOCs on informational content.

Duplicate anchor IDs. Two headings with the same text create duplicate IDs — most plugins handle this by appending a number, but it’s worth checking. Two sections with identical headings is usually a sign the headings need revising anyway.

Not testing after publishing. Click every TOC link on the live post. Fixed header issues, theme CSS conflicts, and plugin interactions can all cause links to jump to the wrong location. Testing takes two minutes.

Forgetting to update manual TOCs after edits. If you restructure a post with a hand-built TOC, the old links break. This is the tax on the manual approach.

Frequently Asked Questions

What is a table of contents in a blog post? A list of the post’s major sections, each linked to the corresponding heading via an anchor link. Readers click an entry to jump directly to that section. TOCs appear near the top of long-form posts and are standard on how-to guides, reference content, and technically structured articles.

Do tables of contents help SEO? Yes, in concrete ways. They create anchor links that make posts eligible for “jump to” links in Google search results. They improve topical structure signals that help Google understand what the page covers. And cleanly delineated sections improve eligibility for featured snippets. None of these are guaranteed, but the structure a TOC creates is the prerequisite for all of them.

What’s the best WordPress TOC plugin? Easy Table of Contents for most sites — free, well-maintained, highly customizable, compatible with both classic and block editors. If you’re on Rank Math, use the built-in TOC block and skip the extra plugin.

Does Yoast SEO include a table of contents? No. Pair Yoast with Easy Table of Contents — they work together without conflict.

How does a TOC work in Showit? Showit blogs are powered by WordPress, so TOC plugins install and function normally in the WordPress admin. The TOC renders in your Showit blog template. You may need minor CSS adjustments to match your design and fix anchor link offset for a fixed header.

Should every blog post have a TOC? No. Useful on posts over ~1,000 words with three or more distinct sections. Not useful — and potentially harmful to conversion — on short posts, landing pages, or any page where you want the reader to move through content in sequence rather than navigate freely.

What are “jump to” links in Google? Supplementary links that appear beneath some Google search results, linking directly to specific sections of the page. Google generates them from anchor links on the page — which is what a TOC creates. They expand your search result’s visual footprint and signal to searchers exactly what sections your content covers.


A table of contents is a small investment with a consistently positive return across reader experience, SEO structure, and content credibility. We add one to every long-form post we publish — and we audit for missing TOCs in almost every content program we inherit. It’s the kind of thing that’s invisible when it’s there and annoying when it’s not.

If you’re building a content infrastructure and want help thinking through what “correct” actually looks like across your full blog and SEO program, that’s part of what we do. Strategy sets the direction. The technical layer is what makes it work.

Read the Comments +

Leave a Reply

Your email address will not be published. Required fields are marked *

ALL the  LATEST

In the Mood

Consider this your blog playlist. Search the blog or browse some of the top searches / categories below.

as seen in:

Juicy insights and pictures of our clients' dogs

Click For Dogs

Very business. Very serious. 

Circle Back Now

We won't call it X. Unfiltered marketing thoughts.

Follow Along