How to Create a WordPress Table of Contents for Post

If you write really long articles in WordPress, it can very helpful to have a table of contents at the top of the post. This acts as a quick summary so readers can scan the content and perhaps jump down to a topic they're really interested in.

With the Easy Table of Contents plugin, you can insert a table of contents in a WordPress post. Every heading in the post will be accessible through a link at the beginning. This image shows the plugin in action:

A Table of Contents for a WordPress post

This tutorial will explain the installation and basic usage of the Easy Table of Contents plugin.

Step #1. Install Easy Table of Contents

  • In your WordPress site, click Plugins > Add new.
  • Type easy table in the search box.
  • Choose the Easy Table of Contents plugin.
  • Click Install now and then Activate.
Installing the Easy Table of Contents plugin

Step #2. Easy Table of Contents configuration

  • On the Plugins page, click the Settings link for your new plugin.
Easy Table of Contents plugin settings

The Easy Table of Contents configuration is divided into three main areas: 

  • General
  • Appearance
  • Advanced

General Settings

The General settings control how and where table of contents appear on your site.

By default, the table of contents will only appear on Pages. You can change that using the “Enable Support” option at the top of the screen.

You can also control whether or not the table of contents is inserted automatically. In the image below, the table is being automatically inserted into all my Posts.

  • Check Auto insert posts
  • Leave the default Heading position
Plugin settings for posts and pages

A little further down the screen, you can control where the table of contents appears. I've choosen “Before first heading”. This is the position you can see in the very top image in this tutorial.

Easy Table of Contents plugin settings for positions

Scroll further down and you can customize the table of contents in more ways. Here are some of my recommendations:

  • Change the number of headings to 3
  • Edit the Header label
  • Change the Counter style to Roman
  • Leave the other default values
Plugin advanced settings


The Appearance section allows you to configure the look and style of the table of contents, including the size of the fonts. Again, I'll give you some recommended settings, based on my testing of the plugin.

  • Leave the default Auto width

The custom width option does not apply since the default width is Auto.

  • Change the Title font size
  • Change the Text font size
  • Choose Custom, to create a customized style for the Table of contents
Easy Table of Contents plugin appearance settings
  • Change the Custom theme colors according to your taste, or to the design mockup

Notice that there is a button to reset the color to its default style, in case you want to start over from the default style.

Easy Table of Contents plugin color settings


This final section has small tweaks to deeply customize your table of contents.

One very useful option is “Exclude Headings”. This is useful if your article is very long and you do not want to clutter the table with subtopics (for example headings in the fifth or sixth level). You can also exclude headings that aren't content-related: for example “Advertisement” or “Sponsored”. The image below the * character is a wildcard.

Easy Table of Contents plugin advanced settings

The last configuration options refer to several key features

  • The offset that has to be preserved when scrolling (the scroll effect) on desktop or mobile devices.
  • Limiting the path to pages with a certain URL pattern (this provides great flexibility).
  • Pinning the table of contents inside a widget area (sidebar).
Easy Table of Contents plugin final settings

Step #3. Creating a WordPress Table of Contents

  • Create a post with multiple headings
  • Make sure you include h5 and h6 headings. 
  • Include these two headings:
    • Sponsored content
    • Advertisement

One thing to notice is that you can override the global settings of Easy Table of Contents per post. This provides even more flexibility since you can customize each one of the content tables to your specific needs.

Easy Table of Contents plugin live in a WordPress post

Easy Table of Contents summary

The Easy Table of Contents plugin inserts a content table into your WordPress posts. Each link of the list takes the reader to that section of the article by using an animated scroll effect. This is very useful on particularly long articles because it helps visitors get a clear overview of the whole text.

More useful WordPress plugin recommendations

Get the PublishPress plugins

The Pro versions of PublishPress plugins are packed with extra features to help you manage your content. Get a PublishPress membership today for full access:

Jorge Montoya

Jorge lived in Ecuador and Germany. Now he is back in his homeland of Colombia. He spends his time translating from English and German to Spanish. He loves to learn about open source technology.


Leave a Reply

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

Professional publishing plugins for WordPress! Get PublishPress