How to Add a Table of Contents in WordPress (2026): 4 Methods Compared

Long posts are hard to read without a map. When you add table of contents WordPress visitors can jump straight to the section they need instead of scrolling through 2,000 words. That improves the reading experience, keeps people on the page longer, and can earn your post jump links in Google search results.

You do not need to be a developer. This guide shows you how to add table of contents WordPress the right way, using four methods: the free block inside Rank Math, the popular Easy Table of Contents plugin, manual HTML anchors in Gutenberg, and the features built into some themes. Every price and feature claim here was checked against the official source on 20 November 2026.

In This Guide

  • Why Add a Table of Contents to WordPress Posts?
  • Before You Start: How WordPress Headings Work
  • The 4 Methods Compared at a Glance
  • Method 1: Add Table of Contents WordPress With the Free Rank Math Block
  • Method 2: Easy Table of Contents Plugin
  • Method 3: Manual HTML Anchors in Gutenberg (No Plugin)
  • Method 4: Your Theme’s Built-In Table of Contents
  • Which Method Should You Choose?
  • Common Table of Contents Problems and Fixes
  • Frequently Asked Questions
  • BadilHost Verdict

Why Add a Table of Contents to WordPress Posts?

A table of contents is a list of links at the top of a post that takes the reader to each section. It works like the contents page of a book, and it matters more than most site owners realise.

First, it improves the user experience. Readers arrive from Google with a specific question. If they can see at a glance that your post covers it, they stay; if they face a wall of text, they leave. A clear list of sections tells them the answer is here and exactly where to find it.

Second, it helps your SEO. Google can show jump links from your headings directly in the search results, which attracts more clicks. Rank Math even checks for a table of contents in its readability analysis, and passes the test when it detects its own block or a compatible plugin such as Easy Table of Contents. Third, it makes long content feel shorter: a 2,500-word tutorial looks intimidating as one block of text, but the same tutorial with eight clear sections looks manageable.

Before You Start: How WordPress Headings Work

Every method in this guide builds on the same foundation: your headings. A table of contents is generated from the H2 and H3 tags in your post, so the list is only as good as your headings.

Use one H1 for the post title, which WordPress adds automatically. Use H2 tags for the main sections and H3 tags for subsections inside them. Never use bold text instead of a heading, and never skip from H2 straight to H4. Screen readers and search engines both rely on that hierarchy.

Write headings that describe the section. “Method 2” tells the reader nothing, while “Method 2: Easy Table of Contents Plugin” tells them exactly what they will find. Before you add table of contents WordPress posts, open the document outline in the block editor, fix duplicates and vague headings first, and remember that every heading you see there will appear in the list your readers see.

The 4 Methods Compared at a Glance

Here is the short version. The detailed steps for each method follow below.

Method Cost Plugin needed? Automatic on old posts? Best for
Rank Math TOC block $0 (free version) No, if Rank Math is installed No, added per post Sites already running Rank Math
Easy Table of Contents $0 (free version) Yes Yes, auto-insert Whole-site TOCs with no per-post work
Manual HTML anchors $0 No No, built by hand Full control, or very few long posts
Theme-built TOC $0 No Depends on the theme Themes such as Kadence that include one

The cheapest option is not always the best one. Before the details, here is how the four ways to add table of contents WordPress compare, so you can pick the method that fits how many long posts you publish and how much control you want.

Four methods to add a table of contents in WordPress compared side by side: plugin settings, Gutenberg block, code anchors and theme options

Method 1: Add Table of Contents WordPress With the Free Rank Math Block

This is the method we recommend first, and it is the one we use on BadilHost. If you already run Rank Math, you already own everything you need to add table of contents WordPress posts with, and the block costs nothing extra.

Rank Math’s Table of Contents block is included in the free version of the plugin. It works only in the Block Editor, and Rank Math’s own documentation notes that you need the Schema module enabled to use it. The block reads your headings and builds the list automatically, and it adds SiteNavigationElement schema to the page, which helps search engines understand the structure of your post. The current free version is 1.0.282, released 10 November 2026.

How to add the Rank Math TOC block

  1. Open the post in the Block Editor and click where you want the list to appear, usually right after the introduction.
  2. Click the add block (+) button and search for “Table of Contents”. Choose the Table of Contents by Rank Math block.
  3. Give the list a title, such as “In This Guide”.
  4. Rank Math generates the list from your headings automatically. Add or reorder a heading and the list updates.
  5. To hide a heading from the list, select the block and click the eye icon next to that heading.

That is all it takes to add table of contents WordPress posts with Rank Math.

Open Rank Math SEO > General Settings > Blocks to set the defaults for every post: the default title, which heading levels to include, and the list style. These defaults save time every time you add table of contents WordPress posts with Rank Math.

The main limitation is that the block lives in one post. It will not appear on older articles automatically, so you need to add it to each post. For most blogs that publish a few posts a month, that is a small job, and it is still the simplest way to add table of contents WordPress posts one at a time. If you want a list on hundreds of old posts without opening each one, Method 2 is the better choice. See the official Rank Math Table of Contents documentation for the full instructions.

Method 2: Easy Table of Contents Plugin

Easy Table of Contents is the most-installed dedicated table of contents plugin on WordPress.org, with 600,000+ active installs and a 4.4 out of 5 rating. It is free, and its main strength is automation: once configured, it inserts a table of contents into your posts without you touching each one.

The free version auto-inserts the list based on your settings, supports the [ez-toc] shortcode for manual placement, and works with the Classic Editor, Gutenberg, Elementor, Divi and WPBakery. It also supports Rank Math, and it is the most popular way to add table of contents WordPress beginners choose. A Pro version exists that adds a Gutenberg block and extra positions, but the free version covers everything most sites need. It is the quickest way to add table of contents WordPress lists across a whole site at once.

How to set up Easy Table of Contents

  1. Go to Plugins > Add New, search for “Easy Table of Contents”, then install and activate it.
  2. Open Settings > Table of Contents. Under Auto Insert, choose the post types that should get a list automatically. For most blogs, select Posts.
  3. Set the position, usually before the first heading, and choose the header label, such as “In This Guide”.
  4. Under Appearance, pick a width, alignment, font size and theme for the list.
  5. Under Advanced, choose which heading levels to include. Selecting H2 and H3 only keeps the list short and readable.
  6. Click Save Changes, then open a post to check the result.

To control a single post, use the Table of Contents meta box at the bottom of the editor to enable or disable the list for that post. The trade-off is control: styling the list beyond the built-in themes takes custom CSS. If you publish long tutorials regularly and want the list everywhere with no per-post work, this is the easiest way to add table of contents WordPress sites can rely on.

Method 3: Manual HTML Anchors in Gutenberg (No Plugin)

The manual method uses no plugin at all. You create the list yourself from links that jump to each heading. It takes longer, but it gives you complete control over the wording, the order and the design, and it is the only way to add table of contents WordPress lists with zero added code.

This is also the method behind the “In This Guide” list at the top of this article. BadilHost does not run a table of contents plugin, so every list on this site is built by hand, which is why Rank Math still flags the missing plugin on our own posts even though readers see a working list.

How to build a manual table of contents

  1. Give every H2 heading an HTML anchor. Select the heading block, open the Advanced panel, and type a short anchor in the HTML anchor field, for example why-add-toc. Use lowercase letters and hyphens only.
  2. Add a List block near the top of the post, right after the introduction, and type the title of the list.
  3. Add one list item per section, using the exact heading text.
  4. Select each list item, click the link button, and type # followed by the anchor, for example #why-add-toc.
  5. Test every link in the post preview. A typo means the link goes nowhere, and a duplicate anchor means it jumps to the wrong section.

Choose this method when you publish only a few long posts, when you want the list to use different wording from the headings, or when you keep your plugin count as low as possible. It is also the only method that lets you link to something other than a heading, such as a comparison table. The cost is time: a post with ten sections needs ten anchors and ten links, and every heading you rename later means updating the list too. Manual anchors are the slowest way to add table of contents WordPress posts, but the most flexible, so build the habit of adding anchors while you write, not after you finish.

Method 4: Your Theme’s Built-In Table of Contents

Some WordPress themes include a table of contents feature, so you may not need a plugin or a manual list at all. Whether this method works for you depends entirely on which theme you run.

GeneratePress, the theme BadilHost uses, has no built-in table of contents. The GeneratePress support team confirmed this in the official forums, calling it a dedicated plugin requirement rather than a theme feature. If you run GeneratePress, use Method 1, 2 or 3 instead.

Kadence is the best-known exception. Its theme and its Kadence Blocks plugin include a Table of Contents block, which makes Kadence the easiest theme in which to add table of contents WordPress posts without a separate plugin. Spectra is free on WordPress.org too, with 30+ blocks including a Table of Contents block, and it was formerly known as Ultimate Addons for Gutenberg. Note that in 2026 Spectra split in two: the original continues as Spectra Legacy, and new development moved to a rebuilt Spectra Blocks plugin, so new sites should start there.

To check your theme, open a post in the Block Editor, click the add block (+) button, and search for “table of contents”. If nothing appears, your theme has no built-in option, and you need one of the first three methods. You will know in seconds whether you can add table of contents WordPress lists without a plugin.

A theme-built list has one real advantage: it usually matches your theme’s design without extra styling. The disadvantage is lock-in. If you change themes later, the list disappears with the old theme, and you have to rebuild it with another method. Many site owners still prefer the Rank Math block or Easy Table of Contents for that reason, because those keep working whatever theme you switch to.

Which Method Should You Choose?

There is no single best method, only the best method for your site. Use this quick guide to decide how you will add table of contents WordPress navigation on your site.

If you already run Rank Math, start with Method 1. The block is free, it adds schema automatically, and it costs you no new plugin. It is the fastest way to add table of contents WordPress posts when you publish a few articles a month.

If you have hundreds of posts and want a list on all of them without opening each one, choose Method 2. Easy Table of Contents is free, it auto-inserts everywhere, and you can exclude individual posts when a list does not fit.

If you publish rarely, want total control, or keep your plugin count as low as possible, choose Method 3. Manual anchors are free forever and never break when a plugin updates, but they cost you time on every post.

If your theme already includes a table of contents block and you are happy with your theme long term, use Method 4, remembering that when you add table of contents WordPress lists through a theme, switching themes later means rebuilding the list. One more consideration is performance: a table of contents is a tiny feature, so none of these methods will slow down a healthy site on its own. What matters more is the total number of plugins you run, and our guide on how to speed up WordPress explains how to audit them.

Common Table of Contents Problems and Fixes

Even a simple feature can go wrong. Most issues appear the first time you add table of contents WordPress lists to a post, and here are the problems we see most often, with the fix for each.

The list is empty. The headings are missing or the plugin cannot read them. Check that your sections use real H2 and H3 heading blocks, not bold paragraphs. In the Rank Math block, make sure the Schema module is enabled, because the block depends on it — the first thing to check when you add table of contents WordPress lists and see nothing.

Some headings are missing from the list. The heading level is excluded in the settings. In Easy Table of Contents, open Settings > Table of Contents > Advanced and confirm H2 and H3 are selected. In the Rank Math block, click the eye icon to unhide the heading.

The list appears on pages where you do not want it. In Easy Table of Contents, disable auto-insert for that post type, or use the per-post meta box to turn the list off for a single post. With the Rank Math block, simply delete the block from that post. That is the first setting to check when you add table of contents WordPress lists and they show up in the wrong place.

The list looks broken after a theme change. The old theme styled the list and the new one does not. Check the list in the Customizer and reapply your colours and spacing. If you used a theme-built list, you may need to rebuild it with another method entirely. If the page itself is slow, run the checks in our WordPress speed guide before blaming the list, and see our guides to fixing WordPress 404 errors and the WordPress security checklist for other common causes.

A reader scrolling a long WordPress article on a phone with a floating table of contents menu

Frequently Asked Questions

How do I add table of contents WordPress without a plugin?

Use manual HTML anchors. Give each H2 heading an anchor in the block settings, add a List block after your introduction, and link each list item to its anchor with # followed by the anchor name. That is the whole method to add table of contents WordPress posts without a plugin: a few minutes per post, no plugin, and no extra code on your site.

Is Easy Table of Contents really free?

Yes. Easy Table of Contents is free on WordPress.org, with 600,000+ active installs, and the free version is all most sites need when they add table of contents WordPress navigation. A Pro version exists that adds a Gutenberg block and extra positions, but most sites never need it. You can browse it on the official WordPress.org plugin page.

Does Rank Math’s Table of Contents block cost anything?

No. The Table of Contents block is included in the free version of Rank Math, which has 4+ million active installs, so it is the cheapest way to add table of contents WordPress posts if Rank Math is already installed. You only need the Block Editor and the Schema module enabled. The official Rank Math documentation walks through the setup step by step.

Will a table of contents help my Google rankings?

It can help indirectly. Google may show jump links from your headings in the search results, which can improve your click-through rate, and readers who find what they need stay longer. That is why so many guides recommend you add table of contents WordPress posts longer than 1,000 words. A list does not replace good content, fast loading or real keyword research, but it makes good content easier to use.

Does GeneratePress have a built-in table of contents?

No. GeneratePress has no built-in table of contents feature, and the GeneratePress support team recommends a dedicated plugin instead. GeneratePress users add table of contents WordPress posts with the Rank Math block, Easy Table of Contents, or manual anchors. Our comparison of GeneratePress vs Astra vs Kadence covers the differences between these themes in detail.

Should I add a table of contents to every post?

No. Add table of contents WordPress posts longer than about 1,000 words, or any post with four or more sections. Short posts do not need a list, and a list with only two items looks worse than no list at all. Pages such as your contact page never need one.

BadilHost Verdict

BadilHost verdict: If you already run Rank Math, use its free Table of Contents block — it costs nothing, adds schema automatically, and takes less than a minute per post. If you have hundreds of old posts and want a list everywhere without opening each one, install Easy Table of Contents (free, 600,000+ installs) and let it auto-insert. Only build manual anchors if you publish rarely and want total control, and only rely on a theme-built list if you are sure you will not change themes. Whatever method you choose, add table of contents WordPress posts longer than 1,000 words, keep the list to H2 and H3 headings, and test every link before you publish.

The Bottom Line

A table of contents is one of the cheapest improvements you can make to a WordPress site. It costs nothing with any of the four methods in this guide, it takes minutes to set up, and it makes long posts easier to read and more likely to earn jump links in Google.

Start with the method that fits your site today, and add table of contents WordPress navigation to your next long post first. If you run Rank Math, add its free block to your next post. If you want the list everywhere, set up Easy Table of Contents once and forget about it. Once you add table of contents WordPress readers will notice the difference on the very next long post. And if you are just starting out, our guides to start a WordPress website and the WordPress backup guide will help you build the rest of the foundation properly.

1 thought on “How to Add a Table of Contents in WordPress (2026): 4 Methods Compared”

Leave a Comment