Marc Tönsing

<p>Add a Table of Contents block to your posts and pages. The TOC is a nested list of links to all heading found in the post or page. To use it, simply add a block and search for “SimpleTOC” or just “TOC”.</p>
<p>The maximum depth of the toc can be configured in in the blocks’ sidebar among many other options. There can hide the headline “Table of Contents” and add your own by using a normal heading block.</p>
<p><a href="https://demo.tastewp.com/simpletoc" rel="nofollow ugc">Spin up</a> a new WordPress instance with the SimpleTOC plugin already installed.</p>
<h4>User Feedback</h4>
<blockquote>
<p>“It is lightweight, stable, and fully compatible with WordPress Full Site Editing. A reliable solution that integrates seamlessly and performs exactly as expected.”<br />
  — <a href="https://wordpress.org/support/topic/good-job-1889/" rel="ugc">@js100 on wordpress.org</a></p>
<p>“Does the job perfectly, and adds no bloat.”<br />
  — <a href="https://wordpress.org/support/topic/does-the-job-perfectly-and-adds-no-bloat/" rel="ugc">@clicknathan on wordpress.org</a></p>
<p>“Simple yet powerful. Great plugin that does exactly what you need.”<br />
  — <a href="https://wordpress.org/support/topic/simple-yet-powerful-106/" rel="ugc">@mixey on wordpress.org</a></p>
</blockquote>
<h4>Accessibility</h4>
<p>This plugin is designed & developed for WCAG 2.2 level AA conformance. The plugin is tested with assistive technology and intended to be accessible, however some third party plugins or themes may affect the individual accessibility on a given website. If you find an accessibility issue, please <a href="https://github.com/mtoensing/simpletoc/issues" rel="nofollow ugc">let us know</a> and we’ll try to address it promptly.<br />
Hidden TOCs use native <code><details></code> and <code><summary></code> semantics without extra ARIA references that require custom IDs.</p>
<h4>Features</h4>
<ul>
<li>Designed for Gutenberg.</li>
<li>Zero configuration: Add the SimpleTOC block to your post and that’s it. </li>
<li>Minimal and valid HTML output.</li>
<li>Utilizes the browser’s built-in details tag for a collapsible interface.</li>
<li>No JavaScript or CSS by default. Optional features such as the accordion menu, smooth scrolling, or box style add minimal assets only when enabled.</li>
<li>Optional box style for the TOC with a default gray background.</li>
<li>Style SimpleTOC with Gutenberg’s native group styling options.</li>
<li>Inherits the style of your theme.</li>
<li>Smooth scrolling effect using CSS. </li>
<li>Accessibility built-in by following web standards.</li>
<li>Optional ARIA Label and navigation role attributes.</li>
<li>Translated in <a href="https://translate.wordpress.org/projects/wp-plugins/simpletoc/" rel="nofollow ugc">multiple languages</a>. Including German, Japanese, Chinese (Taiwan), Dutch, Brazilian Portuguese, French, Spanish and Latvia.</li>
<li>Ideal for creating a Frequently Asked Questions section on your website.</li>
</ul>
<h4>Customization</h4>
<ul>
<li>Administrators can utilize global settings to supersede the individual block settings.</li>
<li>Add background and text color with Gutenberg groups.</li>
<li>Native block support for wide and full width.</li>
<li>Control the maximum depth of the headings.</li>
<li>Choose between an ordered, bullet HTML list. Or indent the list.</li>
<li>Enable a box style and choose a box color directly in the block sidebar.</li>
<li>Select a heading level or turn it into a paragraph.</li>
<li>Disable the h2 heading of the TOC block and add your own.</li>
</ul>
<h4>Compatibility</h4>
<ul>
<li>GeneratePress and Rank Math support.</li>
<li>Works with popular AMP plugins.</li>
</ul>
<h4>How to contribute</h4>
<p>SimpleTOC is open-source and developed on <a href="https://github.com/mtoensing/SimpleTOC" rel="nofollow ugc">GitHub Pages</a>. If you find a bug or have an idea for a feature please feel free to contribute and create a pull request.</p>
<h3>Credits</h3>
<p>This plugin is forked from <a href="https://github.com/pdewouters/gutentoc" rel="nofollow ugc">pdewouters</a> and uses code from <a href="https://github.com/shazahm1/Easy-Table-of-Contents" rel="nofollow ugc">Easy-Table-of-Contents</a></p>
<p>Many thanks to <a href="https://tomjn.com" rel="nofollow ugc">Tom J Nowell</a> and and Sally CJ who both helped me a lot with my questions over at wordpress.stackexchange.com</p>
<p>And many more thanks to all the <a href="https://github.com/mtoensing/simpletoc/graphs/contributors" rel="nofollow ugc">developers on GitHub</a> who helped me making SimpleTOC what it is today!</p>
<p>Thanks to Quintus Valerius Soranus for inventing the Table of Contents around 100 BC.</p>


SimpleTOC – Table of Contents Block

This is the simplest plugin which works perfectly what it is meant for.

Awesome Plugin

<p>I like the plugin a lot. It's simple. It works pretty well and has a few configurations but not too many. Thanks for it!<br />(I am using it to learn Wordpress blocks development, which coming from PHP I think it's quite a challenge. Blocks change the development weight from PHP to JS/React a lot!)</p>

Simple TOC it's just ... simple


Creating and maintaining a plugin requires a significant amount of effort and dedication. It is not a task that can be undertaken by everyone, as it requires an individual with a genuine interest and energy to deliver a product that evolves from being good enough to becoming a perfect product.



We encountered some challenges while using your plugin, but we were pleased to discover that the issue was addressed before we could even report it. We would like to express our sincere appreciation for your active development efforts, which have resulted in the release of version 6.0.2.


Lightweight, effective, actively-maintained


I tested 8-10 table of contents plugins for keyboard and screen reader accessibility and this plugin was by far the best. There was one issue with the accordion that caused a problem for screen reader users, so I opened a support forum thread and the developer released a fix within a few hours. Wow!



This plugin is easy to use, has great HTML markup, and it's refreshing to find a developer who takes accessibility seriously. I'd give it 10 stars if I could. Don't even look for another table of contents plugin.


Great plugin that prioritizes accessibility!


If you add this block/plugin and try to use Back to Top feature in GeneratePress it will turn something that works into something that takes 15s to scroll to very top.



At first I thought maybe I needed to create a function to change the speed but nope, it's this plugin....


Does not have GeneratePress Support — Adds Lag / Delay to Back to Top


Simple, easy to style, to the point and most importantly – works in FSE templates out of the box. No annoying nags in the WP Admin. Thanks!


Works in FSE templates


This is an excellent plugin that easily adds table of contents in your posts / pages and it provides links to the relevant headings.



Does exactly what I want and I would highly recommend it if you are looking for an easy to use tale of contents block plugin.



Thanks so much for sharing.


Great plugin that works really well


Comparing this to the "Table Of Contents Block" by WPDeveloper, I prefer this one because:




It just works automatically.



It has less options, but just enough to do what you need.



It adds nothing to the frontend to cause bloat. No CSS, no JS. At least not right out of the box. Additional settings can be enabled that will add these, but it's nice that we have the option!




This is an example of what a well-written plugin should be.


Does the job perfectly, and adds no bloat

SEO-friendly Table of Contents Gutenberg block. No JavaScript or CSS by default.

Web.Cloud.Apps. GmbH

<p>This plugin automatically generates and inserts a table of contents (ToC) to your pages and posts, based on tags h1-h6. Whenever the plugin discovers more than a certain amount of headings (default: 3) the ToC is inserted at the top of the page. This plugin also can handle posts that are divided into pages by the nextpage-wordpress-tag. Any feedback or suggestions are welcome.</p>
<h4>Available Languages</h4>
<ul>
<li>English</li>
<li>German</li>
</ul>


Extended Table of Contents (with nextpage support)

This plugin automatically generates and inserts a table of contents (ToC) to your pages and posts, based on tags h1-h6. It can deal with nextpage-tag.

SimpleTOC – Table of Contents Block vs Extended Table of Contents (with nextpage support)