Title: Easy Table of Contents
Author: Magazine3
Published: September 9, 2015
Last modified: June 10, 2026
---
Search plugins
# Easy Table of Contents
By [Magazine3](https://profiles.wordpress.org/magazine3/)
[Download](https://downloads.wordpress.org/plugin/easy-table-of-contents.2.0.85.zip)
* [Details](https://wordpress.org/plugins/easy-table-of-contents/#description)
* [Reviews](https://wordpress.org/plugins/easy-table-of-contents/#reviews)
* [Development](https://wordpress.org/plugins/easy-table-of-contents/#developers)
[Support](https://wordpress.org/support/plugin/easy-table-of-contents/)
## Description
A user friendly, featured focused [Easy Table of Contents](https://tocwp.com/) plugin
which allows you to insert a table of contents into your posts, pages and custom
post types.
[Home](https://tocwp.com/) | [Help & Tech Support](https://tocwp.com/contact/) |
[Documentation](https://tocwp.com/docs/) | [Pro version Features](https://tocwp.com/pricing/)
### Features
* **NEW **: Migration Tool to import all the settings from other plugins like Table
of Content Plus & more
* Automatically generate a table of contents for your posts, pages and custom post
types by parsing its contents for headers.
* Supports the `` tag.
* Supports the Rank Math plugin.
* Works with the Classic Editor, Gutenberg, Divi, Elementor, WPBakery Page Builder
and Visual Composer page editors.
* Optionally enable for pages and/or posts. Custom post types are supported, as
long as their content is output with the `the_content()` template tag.
* Optionally auto insert the table of contents into the page, selectable by enabled
post type.
* Provides many easy to understand options to configure when and where to insert
the table of contents.
* Many options are available to configure how the inserted table of contents appears
which include several builtin themes. If the supplied themes do no meet you needs,
you can create your own by choosing you own colors for the border, background
and link color.
* Multiple counter bullet formats to choose from; none, decimal, numeric and roman.
* Choose to display the table of contents hierarchical or not. This means headings
of lower priority will be nested under headings of higher priority.
* User can optionally hide the table of contents. You full control of this feature.
It can be disabled and you can choose to have it hidden by default.
* Supports smooth scrolling.
* Selectively enable or disabled the table of contents on a post by post basis.
* Choose which headings are used to generate the table of contents. This too can
be set on a post by post basis.
* Easily exclude headers globally and on a post by post basis.
* If you rather not insert the table of contents in the post content, you can use
the supplied widget and place the table of contents in your theme’s sidebar.
* The widgets supports being affixed or stuck on the page so it is always visible
as you scroll down the page. NOTE: this is an advanced option since every theme
is different, you might need support from your theme developer to learn what
the correct item selector to use in the settings to enable this feature.
* The widget auto highlights the sections currently visible on the page. The highlight
color is configurable.
* Developer friendly with many action hooks and filters available. More can be
added by request on [Github](https://github.com/shazahm1/Easy-Table-of-Contents).
Pull requests are welcomed.
* An option to show toc based on dynamic paragraph count.
* An option which Preserve Line Breaks in TOC.
* An option to use the TOC without anchor links in the URL.
* Support for custom taxonomy description.
* Adds SiteNavigation Schema.
#### TAKE IT A STEP FURTHER WITH EASY TABLE OF CONTENTS PRO
With [EASY TABLE OF CONTENTS PRO](https://tocwp.com/pricing/) You will get access
to more professional Settings, options and positions to really push your TOC to
the next level.
* **New – Gutenberg Block **: Easily create TOC in Gutenberg block
without the need of any coding or shortcode. * **New – Elementor Widget **: Easily
create TOC using Elementor Widget without the need of any coding or shortcode. ***
New – Fixed/Sticky TOC **: Users can find the content that they need, much faster
through the option of sticky TOC. * **New – Fixed/Sticky TOC Customization **: Customize
the appearance of Sticky TOC with Theme Design options. * **New – Full AMP Support**:
Generates a TOC with your existing setup and make it AMP compatible automatically.***
NEW – ACF Support **: Easily create TOC with your custom ACF fields. * **NEW – View
More **: Show selected number of TOC heading before user clicks to show remaining
headings. * **NEW – Read Time **: Show time of read for your posts/pages. * **NEW–
Collapsable Sub Headings **: Show/Hide sub headings of the Table of contents. * **
NEW – Highlight Headings **: Sticky heading highlight while scrolling through the
content.
### Shortcode
With Our shortcode feature you are in command of the table of contents with very
little effort and even if you have little to no programming skills.
[ez-toc] Would generate the table of contents.
Below are the attibutes we support and could be useful in configuring the table
of contents:
[header_label=”Title”] – title for the table of contents
[display_header_label=”
no”] – no title for the table of contents [toggle_view=”no”] – no toggle for the
table of contents [initial_view=”hide”] – initially hide the table of contents [
initial_view=”show”] – initially show the table of contents [display_counter=”no”]–
no counter for the table of contents [post_types=”post,page”] – post types seperated
by ,(comma) [post_in=”1,2″] – ID’s of the posts|pages seperated by ,(comma) [post_not_in
=”1,2″] – ID’s of the posts|pages seperated by ,(comma) [device_target=”desktop”]–
mobile or desktop device support for the table of contents [view_more=”5″] – 5,
is the number of headings loads on first view, before user interaction (PRO) [class
=”custom_toc”] – add your own class to the TOC [exclude=”Test”] – exclude heading
from TOC which contain text “Test” [heading_levels=”2,3″] – Show only heading h2
and h3
### Support
We try our best to provide support on WordPress.org forums. However, We have a special
[team support](https://magazine3.company/contact/) where you can ask us questions
and get help. Delivering a good user experience means a lot to us and so we try
our best to reply each and every question that gets asked.
### Bug Reports
Bug reports for Easy Table of Contents are [welcomed on GitHub](https://github.com/ahmedkaludi/Easy-Table-of-Contents).
Please note GitHub is not a support forum, and issues that aren’t properly qualified
as bugs will be closed.
### [JOIN TELEGRAM GROUP COMMUNITY](https://t.me/+XADGN24lHNk0YjE1/)**: Purpose of this group is to get proper suggestions and feedback from plugin users and the community so that we can make the plugin even better.
### Roadmap
* Fragment caching for improved performance.
* Improve accessibility.
* Add Bullet and Arrow options for list counter style.
* [View Full Road Map](https://github.com/ahmedkaludi/Easy-Table-of-Contents/milestones)
### Credit
Easy Table Contents is a fork of the excellent [Table of Contents Plus](https://wordpress.org/plugins/table-of-contents-plus/)
plugin by [Michael Tran](http://dublue.com/plugins/toc/).
### Contact | Help | Technical Support
[Contact Us](https://tocwp.com/contact/)
## Screenshots
[⌊The General section of the settings.⌉⌊The General section of the settings.⌉[
The General section of the settings.
[⌊The Appearance section of the settings.⌉⌊The Appearance section of the settings
.⌉[
The Appearance section of the settings.
[⌊The Advanced section of the settings.⌉⌊The Advanced section of the settings.⌉[
The Advanced section of the settings.
## FAQ
### Ok, I’ve installed this… what do I do next?
You first stop should be the Table of Contents settings admin page. You can find
this under the Settings menu item.
You first and only required decision is you need to decide which post types you
want to enable Table of Contents support for. By default it is the Pages post type.
If on Pages is the only place you plan on using Table of Contents, you have nothing
to do on the Settings page. To keep things simple, I recommend not changing any
of the other settings at this point. Many of the other settings control when and
where the table of contents is inserted and changing these settings could cause
it not to display making getting started a bit more difficult. After you get comfortable
with how this works… then tweak away 🙂
With that out of the way make sure to read the **How are the tables of contents
created?** FAQ so you know how the Table of Contents is automatically generated.
After you have the page headers setup, or before, either way… Scroll down on the
page you’ll see a metabox named “_Table of Contents_“, enable the _Insert table
of contents._ option and Update and/or Publish you page. The table of contents should
automatically be shown at the top of the page.
### How are the tables of contents created?
The table of contents is generated by the headers found on a page. Headers are the
[`,,,,,` HTML tags](http://www.w3schools.com/tags/tag_hn.asp).
If you are using the WordPres Visual Post Editor, these header tags are used and
inserted into the post when you select one of the [_Heading n_ options from the formatting drop down](http://torquemag.io/wordpress-heading-tags/).
Each header that is found on the page will create a table of content item. Here’s
an example which will create a table of contents containing the six items.
```
Item 1
Item 2
Item 3
Item 4
Item 5
Item 6
```
You can also create “nested” table of contents. This is difficult to explain so
I’ll illustrate building on the previous example. In this example a table of contents
will be created with the same six items but now the first three will each an child
item nested underneath it. The indentation is not necessary, it was only added for
illustration purposes.
```
Item 1
Item 1.1 -- Level 2
Item 2
Item 2.1 -- Level 2
Item 3
Item 3.1 -- Level 2
Item 4
Item 5
Item 6
```
You are not limited to a single a single nested item either. You can add as many
as you need. You can even create multiple nested levels…
```
Item 1
Item 1.1 -- Level 2
Item 1.1.1 -- Level 3
Item 1.1.2 -- Level 3
Item 1.1.3 -- Level 3
Item 1.2 -- Level 2
Item 1.2.1 -- Level 3
Item 1.2.2 -- Level 3
Item 1.2.3 -- Level 3
Item 1.3 -- Level 2
Item 2
Item 2.1 -- Level 2
Item 2.2 -- Level 2
Item 3
Item 3.1 -- Level 2
Item 3.2 -- Level 2
Item 4
Item 5
Item 6
```
You can nest up 6 levels deep if needed. I hope this helps you understand how to
create and build your own auto generated table of contents on your sites!
### Is there any shortcode to add the table of content to anywhere I want ?
Yes you can add the TOC with this shortcode – [ez-toc] and with the help of this
you can easily add the TOC in the content or anywhere in the WordPress and if you
want to add the shortcode on the theme file then you can add it with the help of
this code – and with this, you can add the TOC on any file according to your need.
## Reviews
### [Spam link injections in plugin](https://wordpress.org/support/topic/spam-link-injections-in-plugin/)
[sohail2000](https://profiles.wordpress.org/sohail2000/) May 27, 2026
i bought easy table of contents module for wordpress from them but it does not work
as expected. i asked them to check. they gave me a new module file to upload to
my website but it has spam link injections as blocked by cloudflare. i asked them
to give updated module through their official channel which they said will do but
never did it. they are just trying to spent time. i asked them to refund multiple
times but they donot reply. theeir terms and cond clearly states that payment is
refunded if they are unable to resolve issue of customer.
### [Great Support](https://wordpress.org/support/topic/great-support-6602/)
[rafiqaqil1](https://profiles.wordpress.org/rafiqaqil1/) April 22, 2026
Excellent support! The team was very helpful and resolved my issue. Highly recommended.
### [Work correct](https://wordpress.org/support/topic/work-correct-2/)
[slavomir12](https://profiles.wordpress.org/slavomir12/) February 22, 2026
Thank you very much your work developers. I am very grateful for your wok and for
your helpful plugin.
### [Great Plugin With Nice Settings](https://wordpress.org/support/topic/great-plugin-with-nice-settings/)
[hernan96](https://profiles.wordpress.org/hernan96/) February 19, 2026
I was looking for a plugin about Table of Contents and I found the indicated one.
There was an issue regarding compability with Elementor but the support team was
able to solve it. I have to note the support team was extremely helpful. I fully
recommend this plugin.
### [Very elegant and unobtrusive TOC-solution](https://wordpress.org/support/topic/very-elegant-and-unobtrusive-toc-solution/)
[Oligraph](https://profiles.wordpress.org/midway88/) February 5, 2026
I am very happy to have found this plugin: it is elegant and functional. And it
can be set to display in a visually unobtrusive size, which was my major concern.
I can style it easily with some CSS. And it translates well with WPML. I can highly
recommend it!
### [Thank you](https://wordpress.org/support/topic/thank-you-3693/)
[MJ Habib](https://profiles.wordpress.org/mjhabib4/) October 30, 2025
This plugin makes adding a table of contents effortless. It auto-detects headings,
is easy to configure, and gives me simple options to control where and how the TOC
appears. It’s saved me time and improved navigation on long posts — thank you!
[ Read all 219 reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/)
## Contributors & Developers
“Easy Table of Contents” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Magazine3 ](https://profiles.wordpress.org/magazine3/)
“Easy Table of Contents” has been translated into 21 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/easy-table-of-contents/contributors)
for their contributions.
[Translate “Easy Table of Contents” into your language.](https://translate.wordpress.org/projects/wp-plugins/easy-table-of-contents)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/easy-table-of-contents/),
check out the [SVN repository](https://plugins.svn.wordpress.org/easy-table-of-contents/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/easy-table-of-contents/)
by [RSS](https://plugins.trac.wordpress.org/log/easy-table-of-contents/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 2.0.85 10/06/2026
* Improvement : Collapsible Sub Headings not working for h3 under h2 #969
* Improvement: New design for sticky toc #968
* Fixed: Easy TOC Conflict with Divi Builder with latest update 2.0.84 #967
* Fixed: Easy TOC Conflict with Elementor Builder After latest update 2.0.84 #966
#### 2.0.84 29/05/2026
* Fixed: EZ TOC includes rendered shortcode HTML when generating heading text and
anchor IDs #961
* Fixed: Auto Insert After 2nd+ Image Breaks WordPress Gallery Closing Tag #963
* Fixed: Duplicate TOC Headings Generated on YOOtheme Builder Pages #964
* Fixed: Auto-Generated TOC No Longer Works with Ultimate FAQ Accordion After Last
Update of ETOC #962
#### 2.0.83 08/05/2026
* Fixed: TOC menu hamburger gets stucked #945
* Fixed: ETOC widget sticky shodecode not working properly. #921
* Fixed: Bug while adding short code #953
* Fixed: Smooth Scroll and exclude from url not working when using data-href option#
956
* Fixed: Divi 5 Compatibility Issue with Easy TOC Causing Fatal Error #955
* Fixed: Mobile ignores custom width setting when “User Defined” is selected #958
* Test: Tested upto WordPress 7.0
#### 2.0.82.2 26/03/2026
* Fixed: Missing null check for global $post causing PHP warnings in REST API post
creation #951
* Fixed: cn_toc_admin_data is not defined ReferenceError: #950
#### 2.0.82.1 21/03/2026
* Fixed: Sticky TOC does not open after the latest update (version 2.0.82). #949
* Fixed: Table Numbers and Sticky TOC Not Rendering (Counter & Sticky Function
Failure) #948
#### 2.0.82 20/03/2026
* Fixed: Underlined Header Issue in elementor text editor #944
* Fixed: ‘Disable Sticky TOC’ setting ignored (Pro filter result overwritten by
free plugin) #940
* Fixed: Authenticated (Contributor+) CSS Injection in <= 2.0.80 reported by Wordfence(
type5afe)
#### 2.0.81 18/02/2026
* Fixed: Make “Exclude Headings by Class” work if class is contained inside the
heading #941
* Fixed: CSRF vulnerabilty in <= 2.0.80 reported by Patchstack (Mike Montoya)
* Fixed: Import not working #938
* Compatibility: Compatibility with hubbub pro #939
#### 2.0.80 31/12/2025
* Fixed: Alternate heading option is not working #932
* Fixed: View more is not working properly #933
* Fixed: Headings not showing in TOC when using captial H2 #916
* Fixed: Title is not redirecting correctly (user-specific issue) #934
* Fixed: Read Time option is not working properly #935
* Fixed: Export Setting option is not working as expected. #936
#### 2.0.79.2 09/12/2025
* Fixed: Pro settings are not visible #931
#### 2.0.79.1 09/12/2025
* Fixed: Error in v2.0.79 – White Screen of Death #930
#### 2.0.79 08/12/2025
* Fixed: Vulnerability Authenticated (Contributor+) Stored Cross-Site Scripting
reported by Wordfence (Jack Taylor)
* Improvement: Code Improvement #928
* Test: Tested upto WordPress 6.9
#### 2.0.78 27/11/2025
* Added: Promotion Banner BFCM #926
* Compatibility Added: Need to make a compatible with the SeedProd builder. #922
* Improvement: ETOC not working with Beaver theme #920
#### 2.0.77 15/11/2025
* Improvement: Added hook/filter to modify product_category HTML content before
rendering #911
* Improvement: Make two/three responsive columns easy table of contents #670
* Feature: Option to show TOC only when certain word count is present #912
* Feature: Create box title or legend for toc container #913
* Compatibility: Need to make a compatible with the SeedProd builder. #922
#### 2.0.76 20/08/2025
* Bug: Heading not highlighting when using shortcode #900
* Bug: Conflict issue with GP Premium 2.4.1 Version. #901
* Bug: Youtube video not visible on frontend #893
* Improvement: TOC sticky widget improvements #904
#### 2.0.75 30/06/2025
* Bug: TOC is not working on ACF fields #878
* Bug: Sticky TOC incorrectly adds ‘ez-toc-section’ span on Pages even when disabled
for Page post type #884
* Bug: Issue with Tasty recipe plugin #891
* Bug : Error in recent update #886
* Compatibility: Easy TOC not picking up heading in ACF flexible headings components#
896
* Improvement: option to hide the ‘TOC’ feature in the Classic Editor. #888
#### 2.0.74 05/05/2025
* Bug: Accordion TOC disappears when clicking at the + / – icon #880
* Bug: The post content is scrolled to the top while using Sticky Widget #879
* Bug: Generatepress Elements not working #867
* Compatibility: PMPRO – File deleted after upload when TOC plugin is activated#
877
* Compatibility: Blocksy child theme Compatibility #875
* Improvement: Redundant Title Text in TOC Causing Accessibility Warning #868
* New: Option to show/disable TOC on mobile/desktop on specific post/page #845
* Test: Need to test with WordPress 6.8 #882
#### 2.0.73 12/03/2025
* New: Added a Sitemap Feature #835
* Tweak: Some TOC Headings Not Working When Added with Elementor Plugin #857
* Tweak: Improvement done in the Appearance Section of the Easy TOC Plugin #858
* New: Added an Option to Add Self-Referencing Links with Domain Anchors in Easy
TOC #859
* New: Delete All Data When Uninstalling the Plugin #863
* Compatibility: Added compatibility with the theme Divi Child #864
* Bug: Code improvement in widget toc shortcode #870
#### 2.0.72 27/01/2025
* New: Expand/Collapse Option for Device Target in TOC for Improved Usability #
824
* New: Easy TOC Integration with Yoast SEO Schema #821
* New: Generate TOC without Links #796
* Bug: Conflict issue with customization settings #840
* Bug: Headings issue with the Kadence Child theme in the product category. #820
* Bug: ‘Header Label‘ Option Not Updating in CATEGORY, TAG individually #852
* Bug: The Read Time option’s label field is not visible #853
* Fix: Customisation of widget title tag #855
* Bug: On multisite, When plugin activated, It goes to not found page #802
* Fix: Need an option for Translating the ‘Toggle Table of Content’ aria-label’#
860
* Compatibility: We need to make compatibility with YOOtheme. #856
#### 2.0.71 09/12/2024
* New: Support for more attributes in shortcode #828
* New: Automatically short the title in ETOC #830
* New: Floating layout for Sticky ETOC #844
* Bug: cookie “ezTOC_hidetoc-0” does not have an appropriate “SameSite” attribute
value #822
* Bug: TOC Short code causing 500 error on Uncode theme #831
* Bug: The Sticky Toc title does not shift to the right in the option Heading Text
Direction selected as Right to Left is selected #833
* Bug: ‘Header Label’ Option Not Updating in post individually #837
* Fix: Issue with “TOC open on load” option in Sticky TOC feature. #815
* Fix: TOC conflict with Avada Builder plugin and Custom Child Theme #775
* Fix: Undefined Array Key ‘navigation_scroll_bar’ in class-eztoc-widgetsticky.
php #842
* Fix: Error in Google search console when enabling Create by Mediavine #841
* Fix: Compatibility with Customize Post Categories for WPBakery Page Builder plugin&
Publisher Theme #843
* Compatibility: Tested with WordPress 6.7 #836
#### 2.0.70 17/10/2024
* New: One click migration for Table of Contents plus plugin #826
* New: Add missing parameters in sticky widget shortcode #812
* Bug: Timber theme TOC links not working on all pages and When ACF compatibility
is on homepage gives 500 error #814
* Bug: Incorrect Symbols Displaying When Adding %PAGE_NAME% as Header Label #816
* Fix: Preserve-Linebreaks is broken. #806
#### 2.0.69.1 05/09/2024
* Fix: Fatal error #803
Full changelog available at [changelog.txt](https://plugins.svn.wordpress.org/easy-table-of-contents/trunk/changelog.txt)
## Meta
* Version **2.0.85**
* Last updated **4 weeks ago**
* Active installations **600,000+**
* WordPress version ** 5.0 or higher **
* Tested up to **7.0**
* PHP version ** 5.6.20 or higher **
* Languages
* [Chinese (China)](https://cn.wordpress.org/plugins/easy-table-of-contents/),
[Chinese (Taiwan)](https://tw.wordpress.org/plugins/easy-table-of-contents/),
[Croatian](https://hr.wordpress.org/plugins/easy-table-of-contents/), [Dutch](https://nl.wordpress.org/plugins/easy-table-of-contents/),
[Dutch (Belgium)](https://nl-be.wordpress.org/plugins/easy-table-of-contents/),
[English (US)](https://wordpress.org/plugins/easy-table-of-contents/), [French (France)](https://fr.wordpress.org/plugins/easy-table-of-contents/),
[Galician](https://gl.wordpress.org/plugins/easy-table-of-contents/), [German](https://de.wordpress.org/plugins/easy-table-of-contents/),
[Greek](https://el.wordpress.org/plugins/easy-table-of-contents/), [Italian](https://it.wordpress.org/plugins/easy-table-of-contents/),
[Japanese](https://ja.wordpress.org/plugins/easy-table-of-contents/), [Korean](https://ko.wordpress.org/plugins/easy-table-of-contents/),
[Persian](https://fa.wordpress.org/plugins/easy-table-of-contents/), [Polish](https://pl.wordpress.org/plugins/easy-table-of-contents/),
[Portuguese (Brazil)](https://br.wordpress.org/plugins/easy-table-of-contents/),
[Russian](https://ru.wordpress.org/plugins/easy-table-of-contents/), [Spanish (Chile)](https://cl.wordpress.org/plugins/easy-table-of-contents/),
[Spanish (Spain)](https://es.wordpress.org/plugins/easy-table-of-contents/),
[Spanish (Venezuela)](https://ve.wordpress.org/plugins/easy-table-of-contents/),
[Turkish](https://tr.wordpress.org/plugins/easy-table-of-contents/), and [Vietnamese](https://vi.wordpress.org/plugins/easy-table-of-contents/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/easy-table-of-contents)
* Tags
* [table of contents](https://wordpress.org/plugins/tags/table-of-contents/)[toc](https://wordpress.org/plugins/tags/toc/)
* [Advanced View](https://wordpress.org/plugins/easy-table-of-contents/advanced/)
## Ratings
4.4 out of 5 stars.
* [ 166 5-star reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/?filter=5)
* [ 18 4-star reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/?filter=4)
* [ 7 3-star reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/?filter=3)
* [ 10 2-star reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/?filter=2)
* [ 18 1-star reviews ](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/easy-table-of-contents/reviews/)
## Contributors
* [ Magazine3 ](https://profiles.wordpress.org/magazine3/)
## Support
Issues resolved in last two months:
4 out of 10
[View support forum](https://wordpress.org/support/plugin/easy-table-of-contents/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](https://tocwp.com/)