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>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>
<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>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 let us know and we’ll try to address it promptly.</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 added. Unless you activate the accordion menu.</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>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>
<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>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!


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 and no CSS means faster loading.

WPJoli

<p>Joli Table Of Contents is the best table of contents plugin for WordPress. It is user-friendly and highly customizable, designed with performance in mind, it offers a seamless experience for both users and developers. With features like Gutenberg block support, auto-insert options, and multilingual compatibility, it’s the perfect solution for enhancing your website’s navigation.</p>
<p><a href="https://wpjoli.com/docs/joli-table-of-contents/" title="Documentation for Joli Table Of Contents" rel="nofollow ugc">Documentation</a></p>
<h3>⭐HIGHLIGHTS</h3>
<h3>🆕 GUTENBERG BLOCK</h3>
<p>Since v2, you can now use the block to insert a table of contents.<br />
The block lets you easily <strong>HIDE or EDIT</strong> specific headings.<br />
In addition, <strong>the block picks up on headings that would be generated by a third party shortcode or block</strong> but invisible in the actual editor.<br />
In the PRO version, you can override any setting for a specific block from the block settings panel.</p>
<h3>🚀 PERFORMANCE ORIENTED</h3>
<p>Joli Table of contents uses a combination of minified CSS and Javascript to run at maximum speed.<br />
It also does not depend on jQuery to improve performance.</p>
<h3>🧠 SUPERIOR HEADING PROCESSING</h3>
<p>Unlike its competitors, Joli Table of Content picks up on headings hidden behind third-party shortcodes and blocks. This means that it will show the headings that do not directly appear in the editor, but are still present in the front-end !</p>
<h3>🖌 THE MOST CUSTOMIZABLE TABLE OF CONTENTS PLUGIN</h3>
<p>Joli table of contents has been designed to really match your expectations.<br />
Every single part of the table of contents is highly customizable, and uses a CSS variable approach to make it even more customizable.<br />
You can adjust a large array of settings including:<br />
* Margin<br />
* Padding<br />
* Border radius<br />
* Border<br />
* Colors<br />
* Fonts<br />
* and more…</p>
<h3>🔽 ICON OR TEXT TOGGLE</h3>
<p>Choose between a <strong>Text toggle</strong> for a more classic look OR an <strong>Icon toggle</strong> for a more modern approach.</p>
<h3>📐 CUSTOM THEME READY</h3>
<p>Joli Table of contents now bundles a custom theme engine, that lets you <a href="https://wpjoli.com/docs/joli-table-of-contents/customizing/create-my-own-theme/" title="How to create your own theme for Joli Table of contents" rel="nofollow ugc">create your own theme</a>.<br />
There is a lot of CSS variables that you can override or/and create more complex styles.</p>
<h3>🚀 SHOW ONLY A FEW HEADINGS UPON PAGE LOAD (PARTIAL FOLD)  [PRO]</h3>
<p>Improve your page UX with the Partial Fold on load option.<br />
Only show the first few headings upon page load with a “View more” button to expand the table of contents fully.</p>
<h3>📑 ADVANCED AUTO-INSERT RULES [PRO]</h3>
<p>Auto-insert supports multiple additional rules:<br />
* Post type<br />
* Post title<br />
* Post ID</p>
<p>You can also EXCLUDE specific posts by Post title or Post ID</p>
<h3>🎛 DIFFERENT SETTINGS PER POST TYPE [PRO]</h3>
<p>Create different settings per post type for maximum flexibility.<br />
For example you can use Theme 1 for “post” post type, and use Theme 2 for the “page” post types.<br />
Good news is every single setting can be set differently per post type, not just themes !<br />
This also works with custom post types.</p>
<h3>✅ FLOATING TABLE OF CONTENTS [PRO]</h3>
<p>The floating table of contents widget is optionally displayed as the user scrolls the page. It remains hover your content and now features optional navigation buttons and advanced customization !</p>
<h3>✅ SLIDE OUT TABLE OF CONTENTS [PRO]</h3>
<p>The slide out table of contents widget brings more value to your page and makes it more readable. It shows the table of contents in a fixed position on the side of the screen.</p>
<h3>✅ PROGRESS BAR WIDGET [PRO]</h3>
<p>This new widget shows a fixed progress bar over the content and indicates the percentage of advancement throughout the reading.</p>
<h3>✅ STICKY SIDEBAR TABLE OF CONTENTS [PRO]</h3>
<p>Use the table of contents in a sidebar widget and have it sticky as the page gets scrolled.</p>
<h3>📃 Main Features</h3>
<ul>
<li>TOC Title icon (since v2.7.0).</li>
<li>Customizable Bullet points (since v2.4.0).</li>
<li>Page break <code></code> support (since v2.3.0).</li>
<li>Auto-insert table of contents (select post types and position in the content).</li>
<li>Manual insert table of contents by <strong>block</strong> or <strong>shortcode</strong>.</li>
<li>Hide specific headings (block)</li>
<li>Edit specific headings (block)</li>
<li>Folding/unfolding animation</li>
<li><strong>Customizable</strong> Table of Contents <strong>Title</strong>.</li>
<li>Show headings by custom depth (From <strong><em>H2</em></strong> to <strong><em>H6</em></strong>).</li>
<li>Customizable CSS Icons for expand/collapse buttons (4 free icons, 20 in pro version)</li>
<li>Show TOC only if a minimum of headings has been found in the content (Optional).</li>
<li>Disable headings per text/class</li>
<li><strong>Hierarchical</strong> (amount of empty space customizable) or <strong>Flat View</strong>.</li>
<li>Multiple numeration options (ex: 1. Title 1; 1.2. Subtitle 2, etc…).</li>
<li>Pretty hash in the actual URL (ex: mysite.com/my-article/#subtitle-2</li>
<li>Latin & non-latin characters support for hash  [since 1.3.2]</li>
<li>Multilanguage hash transliteration available (e.g. #История => #istoriya) [since 1.3.3]</li>
<li>Customizable numeration <strong>Separator</strong> (Ex: “.” => “1.1.2”; “-” => “1-1-2”).</li>
<li>Customizable numeration  <strong>Suffix</strong> (Ex: ).” => “1.1.2)”; “/” => “1.1.2/”).</li>
<li>Customizable Padding, Margin, Borders, etc…</li>
<li>6 Auto-insert positions available (See below for details).</li>
<li>Auto-insert to posts and/or pages.</li>
<li>Fully responsive.</li>
<li>Hide or Show Overflowing Headings when viewport cannot fit the whole title length.</li>
<li>Smooth scrolling available.</li>
<li>Customizable TOC Title alignment (left, center, right).</li>
<li>Customizable TOC Toggle button position (left, right) (when folded).</li>
<li>Customizable TOC Toggle button: Text/HTML/Custom icons (open & close states).</li>
<li>Themes included.</li>
<li>Themes settings can be overriden (Colors, size, etc).</li>
<li>Customizable Width: Min/Max Width or 100% Width.</li>
<li>Customizable Font Size, Font Weight.</li>
<li>Optional Shadow.</li>
<li>Colors fully customizable (Table of Contents, Title, Headings, Shadow, Numeration).</li>
<li>Custom CSS available.</li>
<li>Import / Export settings</li>
<li>Developer-friendly. Many hooks provided. (See below for details).</li>
</ul>
<h4>🚀 Joli Table of contents Pro Features include:</h4>
<p><a href="https://wpjoli.com/joli-table-of-contents/" title="Joli Table Of Contents Pro" rel="nofollow ugc">Get Joli Table Of Contents Pro</a></p>
<ul>
<li>All of the free features.</li>
<li><strong>Custom Post Type</strong> Support.</li>
<li><strong>Custom Post Type</strong> Settings.</li>
<li>Exclusive <strong>Floating Widget</strong> that shows the current section.</li>
<li><strong>Slide-out Widget</strong> that shows a fixed table of contents on the side of the screen.</li>
<li><strong>Additional exclusive themes</strong></li>
<li>Force <strong>Enable/Disable</strong> TOC per post settings.</li>
<li>Customizable <strong>Floating Position</strong> ( Top or Bottom ).</li>
<li>Customizable <strong>Floating Offset</strong> (Horizontally & Vertically).</li>
<li>Expands on <strong>Hover or Click</strong>.</li>
<li>Collapses on <strong>Leave hover or Click away</strong>.</li>
<li><strong>Multi-columns mode</strong> (since 1.1.0).</li>
<li>Customizable CSS Icons for expand/collapse buttons (choose from 20 icons)</li>
</ul>
<h4>Auto-insert</h4>
<p>The Auto-insert feature is optional and allows to automatically insert the Table of Contents to your content with the following options.</p>
<p><em>Supported post types:</em><br />
* Post<br />
* Pages<br />
* Custom Post Type <strong><em>[PRO]</em></strong></p>
<p><em>Auto-insert positions:</em><br />
* Before the content<br />
* After the content<br />
* Before H1<br />
* After H1<br />
* Before first H2<br />
* After first paragraph</p>
<h3>Shortcode</h3>
<p>Use the following shortcode within your content to have the table of contents display where you wish to:</p>
<pre><code>[joli-toc]
</code></pre>
<p>If you were using a different TOC plugin, you can use a different shortcode so that you don’t need to update all of your content:</p>
<pre><code>[toc]

// Add this code to your theme's functions.php
add_filter('jolitoc_shortcode_tag', function(){ return 'toc';});
</code></pre>
<h3>🎣 Hooks</h3>
<p>You can use any of the hooks provided to add custom content to the actual Table Of Contents.<br />
List of [all the hooks available here](https://wpjoli.com/docs/joli-table-of-contents/developer-hooks/”Joli Table Of Contents Hooks”).</p>
<p><strong>Examples & How to use ?</strong></p>
<p>Copy & paste the code examples below into your theme’s functions.php file:</p>
<ul>
<li><code>joli_toc_disable_autoinsert</code></li>
</ul>
<p>Globally disables Joli Table Of Contents site-wide.</p>
<pre><code>add_filter('joli_toc_disable_autoinsert', function(){ return true; });
</code></pre>
<ul>
<li><code>joli_toc_disable_js</code></li>
</ul>
<p>For some reason if you do not want the js/css/inline styles to load (could break functionnalities).</p>
<pre><code>//disables js
add_filter('joli_toc_disable_js', function(){ return true; });

//disables css
add_filter('joli_toc_disable_styles', function(){ return true; });
</code></pre>
<ul>
<li><code>jolitoc_shortcode_tag</code></li>
</ul>
<p>Customizes the shortcode tag ( <em>Useful if you were using a different plugin before</em> ).</p>
<pre><code>add_filter('jolitoc_shortcode_tag', function(){ return 'custom-tag';});
</code></pre>
<p>Customizes the title (collapse).</p>
<pre><code>add_filter('joli_toc_toc_title', 'my_custom_title', 10, 1);

function my_custom_title( $title ){ 
    if ($a == $b){
        $title = "My Custom TOC Title";
    }else{
        $title = "My Alternate TOC Title";
    }

    return $title;
}
</code></pre>
<h4>⭐ CHECK OUR OTHER PLUGINS</h4>
<ul>
<li><a href="https://wordpress.org/plugins/smart-auto-featured-image/" rel="ugc">Smart Auto Featured Image</a></li>
<li><a href="https://wordpress.org/plugins/zenform/" rel="ugc">ZenForm</a></li>
<li><a href="https://wordpress.org/plugins/joli-faq-seo/" rel="ugc">Joli FAQ SEO</a></li>
<li><a href="https://wordpress.org/plugins/joli-clear-lightbox/" rel="ugc">Joli CLEAR Lightbox</a></li>
</ul>

Joli Table Of Contents

The Best Table of Contents Plugin for WordPress. User-friendly. Gutenberg Block. Fast & Highly customizable. Auto or manual insert.

SimpleTOC – Table of Contents Block vs Joli Table Of Contents