How to Create a Table of Contents in WordPress Manually or With a Plugin

If your WordPress post is long enough to require a snack break, it is probably long enough to need a table of contents. A good table of contents, or TOC, helps readers jump to the exact section they want, makes long-form content feel less overwhelming, and gives your post a cleaner structure. In plain English, it turns a wall of text into a guided tour.

The good news is that adding a table of contents in WordPress is not complicated. You can build one manually if you like having full control, or you can use a plugin if you prefer to let WordPress do the heavy lifting while you sip coffee and pretend you enjoy debugging CSS. Both methods work. The best choice depends on how often you publish long articles, how much customization you want, and how allergic you are to repetitive tasks.

In this guide, you will learn exactly how to create a table of contents in WordPress manually or with a plugin, when each method makes sense, which common mistakes to avoid, and how to make your TOC more useful for readers without turning it into decorative clutter.

Why a Table of Contents Matters in WordPress

A table of contents is more than a pretty box near the top of a blog post. It improves navigation, especially on long tutorials, product roundups, documentation pages, pillar posts, and in-depth comparisons. Instead of forcing visitors to scroll endlessly, it lets them jump straight to the section they care about most.

It also supports a better reading experience. Readers can scan the outline first, understand what is covered, and decide whether your content answers their question. That is a small usability win, but on the web, small usability wins add up fast.

From an SEO perspective, a TOC does not magically catapult a weak article to page one. Sorry, there is no “click here to rank” button. But it can support on-page structure, clearer heading hierarchy, and better user experience. That matters because well-organized content is easier for people to use and easier for search engines to interpret.

Before You Add a TOC: Clean Up Your Headings

Before you touch any plugin or HTML anchor, make sure your article uses headings properly. Your page title is usually the H1. Main sections should normally use H2 headings. Subsections under those should use H3 headings, and so on. Think of it like a filing cabinet, not a garage sale.

If your headings are inconsistent, your table of contents will also be inconsistent. For example, if you skip from H2 to H4 or use bold text instead of real heading blocks, some TOC tools may ignore sections or build a messy outline. So your first step is simple: make your content structure logical before you automate anything.

Method 1: Create a Table of Contents in WordPress Manually

If you want full control and do not mind a little setup, a manual table of contents is the most lightweight option. No extra plugin. No extra settings panel. No surprise styling that appears out of nowhere like an uninvited houseguest.

How the Manual Method Works

A manual TOC works by creating anchor links. Each link at the top of the post points to a matching section lower on the page. When a reader clicks the link, the browser jumps to that heading.

In the WordPress block editor, you can do this by assigning a unique HTML anchor to each heading block, then linking to that anchor from a list near the top of the article.

Step-by-Step: Manual TOC in the Block Editor

1. Create your article with properly structured headings, such as H2 for main sections and H3 for subsections.
2. Click on a heading block you want to link to.
3. Open the block settings sidebar and find the Advanced section.
4. In the HTML Anchor field, add a short unique ID such as why-use-a-toc or manual-method.
5. Repeat that for each heading you want to include in your table of contents.
6. At the top of the post, create a list of links that points to those anchors using the format #your-anchor-name.

Here is a simple example:

Then, on the actual heading block for “Why a Table of Contents Matters,” you would use the HTML anchor why-use-a-toc.

Pros of the Manual Method

• No extra plugin to install
• Very lightweight and fast
• Complete control over which sections appear
• Works well for evergreen pages with stable structure

Cons of the Manual Method

• Takes longer to create
• Needs manual updates whenever headings change
• Can become annoying on long or frequently edited posts
• Easy to break if anchor names and links do not match exactly

If you publish one or two long guides per year, the manual route is perfectly reasonable. If you publish content at scale, though, you may eventually start muttering at your screen and considering a plugin.

Method 2: Create a Table of Contents in WordPress With a Plugin

A plugin is the faster and more scalable option. Most TOC plugins automatically scan your headings, generate a linked list, and let you control things like placement, heading levels, styling, collapsible behavior, and auto-insert rules.

This is ideal for blogs, affiliate sites, knowledge bases, recipe archives, and any content-heavy website where long posts are common. In other words, if you regularly write “ultimate guides,” plugins are here to save your sanity.

Popular WordPress TOC Plugin Options

Several good options exist, and the right one depends on your editor and workflow.

• Easy Table of Contents is popular for automatic insertion, support for posts, pages, and custom post types, and broad compatibility with editors and builders.
• Table of Contents Plus is an older, well-known option that automatically builds context-specific TOCs and can also generate sitemap-style lists.
• SimpleTOC is a lighter Gutenberg-focused choice that works as a dedicated block and keeps things minimal.
• AIOSEO Table of Contents Block is convenient for users already working inside the AIOSEO ecosystem.
• Yoast’s Table of Contents block is relevant for sites already using Yoast’s premium internal linking blocks.

How to Install and Set Up a TOC Plugin

1. In WordPress, go to Plugins > Add New.
2. Search for your preferred TOC plugin.
3. Click Install Now, then Activate.
4. Open the plugin settings or add its TOC block in the editor.
5. Choose which heading levels to include, such as H2 through H4.
6. Set where the TOC should appear, such as before the first H2 or near the top of the content.
7. Decide whether the TOC should auto-insert on all posts or only on selected content types.
8. Adjust styling, list format, toggle behavior, and mobile display as needed.

Plugin Method Example

Let’s say you are using a plugin that adds a Table of Contents block in Gutenberg. You open a blog post, click the plus icon, search for the TOC block, insert it, and the plugin automatically reads your headings. If your post has H2 and H3 headings, it will usually display H2 items as main entries and indent H3 items underneath. That means you spend less time building the structure manually and more time writing content that is actually worth reading.

Pros of the Plugin Method

• Fast and beginner-friendly
• Automatically updates when headings change
• Useful for large sites and frequent publishing schedules
• Often includes styling and placement controls

Cons of the Plugin Method

• Adds another plugin to your site
• Can introduce styling conflicts depending on theme
• Some plugins include more features than you actually need
• Automatic insertion may require a bit of cleanup

Manual vs. Plugin: Which One Should You Choose?

Choose the manual method if you want the lightest possible setup, you are comfortable editing anchors and links, and you only need a TOC occasionally. It is also a good fit for high-control landing pages where you want every link written by hand.

Choose a plugin if you publish long-form content regularly, want your TOC to update automatically, or prefer a more efficient editorial workflow. For most content sites, the plugin approach is the better long-term solution because it reduces repetitive work and keeps your post structure consistent.

If you are still undecided, here is the practical rule: for one post, manual is fine; for a content strategy, use a plugin.

Best Practices for a Better WordPress Table of Contents

Only Use a TOC When It Actually Helps

Not every 600-word blog post needs a table of contents. If your article is short and has only two headings, a TOC may feel like overkill. Use it when the content is long, layered, or easy to scan by sections.

Keep Headings Clear and Specific

“Stuff You Should Know” is fun at parties, but it is not a useful heading. Your TOC should help readers understand what each section contains. Write descriptive headings that are short, clear, and relevant to search intent.

Do Not Dump Every Tiny Subheading Into the TOC

A TOC with 37 entries is technically a table of contents and emotionally a punishment. Include the heading levels that help readers most. Many sites do well with H2 and H3 only.

Place the TOC Near the Top

Most readers expect the table of contents near the beginning of the article, often after a short introduction. If you bury it halfway down the page, it stops being navigation and becomes a scavenger hunt.

Check Mobile Display

A giant expanded TOC can eat up precious screen space on phones. A collapsible version often works better for mobile users, especially on long tutorials and list posts.

Common Problems and How to Fix Them

The TOC Does Not Show Any Headings

This usually happens when you used bold text or styled paragraphs instead of actual heading blocks. TOC tools rely on real heading tags, not visual guesswork.

The Links Jump to the Wrong Place

Check for duplicate anchors, mismatched IDs, or sticky headers that cover the section title when users click. In some cases, a small CSS offset or smooth-scroll adjustment is needed.

The Design Looks Weird

Some themes add unexpected spacing, font sizes, or list styles. If your TOC suddenly looks like it was designed by three interns in a trench coat, tweak the plugin settings or add custom CSS to match your theme.

The TOC Is Too Long

Reduce the heading depth, rename bloated headings, or exclude minor sections. A TOC should simplify navigation, not create a second article above the article.

Is a Native WordPress TOC Block Enough?

Depending on your setup, you may see a native or host-provided table of contents block in the block editor. Some WordPress environments support an automatically updating TOC block tied to heading blocks. That can be convenient, but availability varies by platform and configuration. For self-hosted WordPress sites, the most universally dependable options are still manual anchors or a dedicated plugin.

So yes, native-style TOC blocks can be useful. But if you want a method that works across more sites, themes, and publishing workflows, manual anchors and proven plugins remain the safer recommendation.

Conclusion

If you want complete control and zero plugin overhead, create your table of contents manually with HTML anchors. If you want speed, automation, and an easier workflow, use a plugin. Neither method is “more professional” by default. The best one is the one that matches how your site is built and how your team actually publishes content.

For most WordPress users, the plugin route is the practical winner because it saves time and keeps long posts organized with less maintenance. But the manual method still deserves respect. It is lightweight, flexible, and surprisingly effective when used on a small number of cornerstone pages.

Whichever route you choose, remember this: a great table of contents is not there to impress search engines with fancy boxes. It is there to help real humans find what they need faster. And when your site becomes easier for humans to use, that is usually a smart move all around.

Experience-Based Tips and Real-World Scenarios

In real publishing workflows, the biggest surprise is not how hard it is to add a table of contents. It is how quickly a good TOC changes the feel of a page. A 2,500-word guide without a TOC can look intimidating even when the content is excellent. Add a clean outline near the top, and suddenly the article feels organized, approachable, and easier to trust. Same article, same information, completely different first impression.

A common scenario happens on blogs that started small and later became serious content sites. At first, the site owner writes occasional posts and does everything manually. That works fine until the archive grows and the average article gets longer. Then comes the moment of truth: the site has 80 tutorials, each one has six to twelve headings, and updating anchor links manually becomes the kind of task people avoid until it becomes an emergency. That is usually when a plugin starts to make a lot of sense.

Another real-world issue is inconsistent heading habits. Many writers are excellent at explaining ideas but surprisingly chaotic with heading structure. One post uses H2 and H3 correctly. The next uses H2, then bold text, then an H4 because it “looked nice.” A TOC plugin is brutally honest in those situations. It exposes structure problems immediately. If the table of contents looks messy, the content outline is probably messy too. That is actually helpful because it forces better editorial discipline.

There is also a design lesson here. Some site owners install a TOC plugin, keep every default setting, and end up with a giant box that looks like it was imported from 2009. Then they decide table of contents blocks are ugly. Usually the problem is not the concept. It is the presentation. A narrower width, cleaner heading labels, smaller heading depth, and a collapsible toggle often make the difference between “helpful navigation” and “why is this filing cabinet sitting on my blog post?”

Manual TOCs, meanwhile, shine on cornerstone pages that do not change often. If you have a flagship guide, a pricing explanation, or a long evergreen resource page, manual anchors can be a smart choice because they keep the page lightweight and predictable. You know exactly which links appear, how they are worded, and where they send readers. That level of control is useful when every element of the page is intentional.

Perhaps the most useful experience-based takeaway is this: a table of contents works best when it reflects the reader’s journey, not just the writer’s outline. If visitors usually want setup instructions, pricing details, troubleshooting steps, or FAQ answers, make sure those sections are clearly named and easy to reach. A TOC is not just a technical feature. It is a promise that says, “You do not have to dig. I will help you find the good stuff.”

SEO Tags