Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Blogging & content · Guide

How to Add a Table of Contents in WordPress

How to Add a Table of Contents in WordPress

Short answer

Add a table of contents in WordPress with a block or a plugin: use the Rank Math or AIOSEO table of contents block for single posts, or Easy Table of Contents to add a list to many posts at once. You can also build one by hand with HTML anchors, but a plugin updates the list when headings change.

Key takeaways

  • A table of contents is a clickable list of links built from a post's headings.
  • Rank Math's block needs the block editor and the Schema module enabled.
  • AIOSEO's table of contents block is part of AIOSEO Pro.
  • Easy Table of Contents can add a list to many posts at once with auto-insert.
  • Include H2 and H3 headings, and leave out H4 to H6 by default.
  • A hand-built list needs an edit every time a heading changes.

What is a table of contents in WordPress?

A table of contents is a clickable list of links near the top of a post that jumps to each heading.

Each item links to one section, so readers can skip to the part they need. The list is built from the headings already in your post, usually H2 and H3 headings.

A table of contents fits long posts best. A 400-word post with 2 headings does not need one, while a 1,500-word guide with 8 sections does. Add it where readers have to scroll a long way to find answers.

Do you need a plugin to add a table of contents?

No, you can build one by hand with anchor links, but a plugin is faster for long posts.

A plugin reads your headings and builds the list for you. It updates the list when you add, remove, or reorder a heading. A hand-built list needs an edit every time a heading changes.

Three common plugin routes exist. Rank Math and All in One SEO both include a table of contents block if you already run one of them. Easy Table of Contents adds a list to many posts at once without editing each one.

Pick the route that matches the plugins you already use.

MethodBest forCost as of November 2026Covers old posts?
Rank Math blockPosts on a site that already runs Rank MathFree with Rank MathNo, one post at a time
AIOSEO blockPosts on a site that already runs AIOSEO ProNeeds AIOSEO ProNo, one post at a time
Easy Table of ContentsMany old posts at onceFree pluginYes, with auto-insert
Hand-built anchorsShort posts with 3 to 5 sectionsFree, no pluginNo, one post at a time

If you run Rank Math, set it up first with our guide on how to set up Rank Math. The table of contents block only works once the plugin is active and set up.

How do you add a table of contents with Rank Math?

Insert the “Table of Contents by Rank Math” block near the top of the post, and it builds the list from your headings.

Rank Math's own guide says the block is only for the block editor, and you must enable the Schema module before you can use it (checked November 2026). Rank Math's table of contents guide also says the block adds anchor links to headings on its own.

  1. Open the post in the block editor.
  2. Click the add block (+) icon where you want the list, usually right after your intro.
  3. Search for “Table of Contents by Rank Math” and click the block.
  4. Add a title for the list, such as “Table of Contents”.
  5. Check that every heading you want appears in the list.

Rank Math reads headings from H2 down to H6, in order, and links each one to its section (checked November 2026). That is 5 heading levels in one list. The plugin also adds SiteNavigationElement schema for the headings in the block, according to its guide (checked November 2026).

You can edit the list after it is built. Click a heading in the block to shorten its text, or click the eye icon next to a heading to hide it. The heading in the post stays the same when you edit its text in the list.

How do you add a table of contents with All in One SEO?

Install AIOSEO Pro, then insert the “AIOSEO - Table of Contents” block in the post.

AIOSEO's own guide says the table of contents block is part of AIOSEO Pro, and the first step is to install and activate the Pro plugin (checked November 2026). AIOSEO's table of contents guide says the block builds the list from your subheadings on its own.

  1. Install and activate AIOSEO Pro, then finish its setup wizard.
  2. Open the post in the block editor.
  3. Click the add block (+) icon where you want the list.
  4. Search for “AIOSEO” and pick the AIOSEO - Table of Contents block.
  5. Check the list, then save the post as a draft or publish it.

AIOSEO says its plugin is used by more than 3 million website owners, according to its guide (checked November 2026). The block lets you change the heading text in the list, hide or reorder headings, and change the list style in the block settings sidebar.

You can also add more than 1 table of contents block to a long post.

AIOSEO's guide to multiple lists says a second block can run in “Synced” or “Standalone” mode, so each list can cover a different part of the page (checked November 2026). Use that only on very long posts, where one list would be too long to scan.

How do you add a table of contents with Easy Table of Contents?

Install Easy Table of Contents, turn on auto-insert, and the plugin adds a list to every post that has enough headings.

Easy Table of Contents builds the list by reading the headers in a post, page, or custom post type, according to its WordPress.org page (checked November 2026). Easy Table of Contents works with the Classic Editor, Gutenberg, Divi, Elementor, WPBakery, and Visual Composer, so it fits most sites.

  1. Go to Plugins > Add New, search for “Easy Table of Contents”, and click Install Now, then Activate.
  2. Go to Settings > Easy Table of Contents.
  3. Tick Posts under the post types to enable.
  4. Set the minimum number of headings that triggers a list, such as 4.
  5. Pick where the list appears, such as before the first heading.
  6. Save the settings, then open a post with at least 4 headings to check it.

The plugin offers 4 counter bullet formats: none, decimal, numeric, and roman (checked November 2026). You can also show the list as a hierarchy, so H3 headings sit nested under their H2 parent. Readers can hide the list if you leave that option on.

Easy Table of Contents also supports smooth scrolling, so a click glides to the heading instead of jumping, according to its WordPress.org page (checked November 2026). It supports the Rank Math plugin too, so the two can run on the same site.

Use auto-insert when you have many old posts to cover. Adding a list to 200 posts by hand takes days, while auto-insert covers them all once the settings are saved. For new posts, check the list on each one before you publish.

How do you add a table of contents without a plugin?

Give each heading an HTML anchor, then link to those anchors from a list at the top of the post.

AIOSEO's manual method says to open the block settings for a heading, scroll to the Advanced section, and type a short tag in the HTML anchor field (checked November 2026). AIOSEO's jump links guide shows the same steps for building jump links by hand.

  1. Click a heading block and open its settings in the right sidebar.
  2. Scroll to Advanced and type a short anchor in the HTML anchor field, such as pricing.
  3. Repeat for every heading you want in the list.
  4. Add a List block near the top of the post.
  5. Select the list text for a heading and add a link to #pricing, with a # in front of the anchor.
  6. Repeat for each heading, then preview the post and click every link.

Keep anchors short, lowercase, and free of spaces. Use hyphens between words, such as how-to-check. A typo in one anchor breaks that one link, while the rest keep working.

Hand-built lists suit short posts with 3 to 5 sections. For longer posts, a plugin saves time and stops the list from going stale when you edit a heading. If you add links between posts too, read our guide on how to add internal links in WordPress so each link uses clear anchor text.

Which headings should the list include?

Include every H2 and H3 heading, and leave out H4 to H6 headings unless a section truly needs them.

H2 headings mark the main sections of a post, and H3 headings mark steps or points inside them. Those two levels give readers a clear map without noise. H4 to H6 headings are for fine detail, and listing all of them makes the list hard to scan.

Write headings as plain questions or short labels. A heading such as “How much does it cost?” tells readers what the section answers. A vague heading such as “More details” tells them nothing, so rewrite it before you publish.

Keep heading order logical. A list that reads H2, H3, H3, H2 is easy to follow, while a list that jumps from H2 to H4 and back confuses readers. Fix heading levels in the editor, not in the table of contents.

The Heading block handbook says headings introduce new sections and organize content, and the block's default level is 2 (checked November 2026).

Check the list after every edit. If you add a section, the plugin list updates on its own, but a hand-built list needs a new line added by hand. Preview the post and read the list from top to bottom before you publish.

How do you style a table of contents?

Change the list style, title, colors, and position in the block or plugin settings, and keep the design plain.

Rank Math lets you change the title and list style for its block in the block settings sidebar.

AIOSEO lets you pick a bullet or numbered list and change the design in the same sidebar. Easy Table of Contents ships with built-in themes, and you can pick your own colors for the border, background, and link color, according to its WordPress.org page (checked November 2026).

Pick a style that matches your theme and stays readable on phones. A light box with dark text works on most themes. Avoid bright background colors that fight with your headings.

Place the list right after your intro paragraph. Readers see it before they start scrolling, and they can jump at once. A list buried halfway down the post helps no one.

On phones, a long list can push your first section far down the page. Use a collapsible list if your plugin offers one, or keep the list to your H2 headings only on long posts. Test the post on a phone before you publish.

How do you check that a table of contents works?

Preview the post, click every link in the list, and confirm each one lands on the right heading.

Start in the editor and read the list. Every heading you want should appear once, spelled the same as the heading in the post. A missing heading means the plugin did not see it, often because it uses the wrong heading level.

Next, click Preview and test the links. Click each item and watch the page move to the right section.

If a click does nothing, the anchor is missing or mistyped. If it lands on the wrong section, two headings may share the same anchor.

Then check the post on a phone. The list should fit the screen, and links should still work with a tap. A list that overflows the screen on mobile needs a narrower design or fewer items.

Also check the schema your plugin adds. Rank Math adds SiteNavigationElement schema for the headings in its block, according to its guide (checked November 2026). Read our guide on how to add schema markup in WordPress if you want to check what structured data your pages carry.

How do you add a table of contents to old posts?

Use auto-insert for old posts, or open each old post and add a block where it helps most.

Easy Table of Contents is the fastest route for a back catalog. Turn on auto-insert for posts, and every old post with enough headings gets a list without an edit. Open 3 or 4 old posts after you save the settings to confirm the lists look right.

With a block plugin, work through old posts in small batches. Open a post, add the block after the intro, check the list, and update the post.

Start with your most visited posts, since those gain the most from better navigation. Read our guide on how to update old posts for SEO to plan the order.

Do not add a list to every old post at once without checking. A post with only 2 headings looks odd with a list, and a post with messy headings needs its headings fixed first. Fix the headings, then add the list.

What mistakes should you avoid?

Do not add a table of contents to short posts, do not list every small heading, and do not leave a stale hand-built list in place.

A list on a 300-word post with 2 headings is clutter, not help. It pushes the first paragraph down the page and gives readers nothing to skip to. Add lists only where a post has at least 4 headings.

Do not include H4 to H6 headings by default. A list with 25 items is as hard to scan as the post itself. Keep the list to H2 and H3 headings, and hide any heading that adds no value.

Do not forget to update a hand-built list. If you rename a heading, its anchor stays the same, but the list text goes stale.

If you delete a section, its list link breaks. Check the list each time you edit the post.

Do not put two table of contents plugins on the same site. They can both try to insert a list, and you end up with two lists on every post. Pick one plugin, remove the other, and clear your cache before you check the result.

Frequently asked questions

When should I add a table of contents to a post?

Add one only where a post has at least four headings and readers must scroll far to find answers. A list on a 300-word post with two headings is clutter. On long guides, a list helps readers jump to the section they need and makes the post easier to scan.

Does the Rank Math table of contents block work in the Classic Editor?

Yes, but use it for its own posts. Rank Math says its table of contents block is only for the block editor, so it will not work in the Classic Editor or in page builders such as Elementor or Divi. For those editors, use Easy Table of Contents instead.

Can I add two tables of contents to the same post?

Yes, for more than one list AIOSEO offers Synced and Standalone modes. A standalone list covers every heading below the block, while a synced list covers one part of the page. Use a second list only on very long posts, where a single list would be too long to scan.

Why is a heading missing from my table of contents?

First check that the missing heading uses H2 or H3, since most lists only include those levels. Then check that the heading text has no odd characters. If the list is hand-built, check that the anchor in the heading matches the link in the list exactly, including hyphens.

How do I check that my table of contents works?

Open the post in a private browser window and click every link in the list. Each one should land on the right heading. Also test the list on a phone, since a wide list can overflow a small screen. Fix any link that does nothing or lands on the wrong section.

Can I use Easy Table of Contents and Rank Math together?

Yes, for most sites one plugin is enough. Running two table of contents plugins can put two lists on every post. Pick one plugin, remove the other, and clear your cache before you check the result.

Sources

  1. Easy Table of Contents WordPress.org
  2. How to Add Rank Math's Table of Contents Block Rank Math
  3. How to Create a Table of Contents in WordPress All in One SEO
  4. How to Create Jump Links in WordPress All in One SEO
  5. Table Of Content Block WordPress.org
  6. Heading block WordPress Developer Resources

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test