How do I add a Table of Contents block to my posts and pages?

To add a Table of Contents block, simply add a block and search for 'SimpleTOC' or 'TOC'.

What are the features of SimpleTOC?

The features of SimpleTOC include being designed for Gutenberg, minimal and valid HTML output, no JavaScript or CSS added (unless you activate the accordion menu), style customization with Gutenberg's native group styling options, inherit the style of your theme, smooth scrolling effect using CSS, optional ARIA Label and navigation role attributes, and translation in multiple languages.

How can I customize SimpleTOC?

You can customize SimpleTOC by utilizing global settings to supersede the individual block settings, adding background and text color with Gutenberg groups, using native block support for wide and full width, controlling the maximum depth of the headings, choosing between an ordered or bullet HTML list, selecting a heading level or turning it into a paragraph, and disabling the h2 heading of the TOC block and adding your own.

What compatibility does SimpleTOC have?

SimpleTOC has compatibility with GeneratePress and Rank Math support, as well as popular AMP plugins.

Who should I credit for SimpleTOC?

SimpleTOC is forked from pdewouters and uses code from Easy-Table-of-Contents. Thanks to Tom J Nowell, Sally CJ, and Quintus Valerius Soranus for their contributions.

SimpleTOC - Table of Contents Block

Easy Table of Contents

Organize your content effortlessly.

Add a Table of Contents block to your posts and pages with just a few clicks. Easily navigate through your content and improve user experience.

Control the appearance of your Table of Contents with options to choose colors, heading levels, and more. Style it to match your theme effortlessly.

Multilingual Support

SimpleTOC is translated into multiple languages, making it accessible to a wider audience. Engage with readers from all around the world.

Accessible and WCAG Compliant

Ensure inclusivity on your website.

Author’s Site

6.7.2

Added: Support for GenerateBlocks 2.0. Thanks @blronaldhuereca
Added: Included an accessibility statement in the plugin description. Thanks Gen Herres.

6.6.1

Added: Initialize the JavaScript for the TOC accordion on page load or after the document has fully loaded. Thanks blronaldhuereca https://github.com/mtoensing/simpletoc/pull/63

6.6.0

Added: Testest compatibility with WordPress 6.7

6.5.6

Fixed: All script versions have been updated to prevent caching issues.
Fixed: Legacy Accordion was always expanded. Thanks Francesco Palmieri.
Added: Updated dependencies for improved performance and stability.
Added: Testest compatibility with WordPress 6.6

6.4.3

Added: A pointer cursor on hover for the hidden TOC

6.4.3

Added: Utilizes the browser’s built-in details tag for a collapsible interface. Thanks @infinitnet
Compatibility with WordPress 6.5
Fixed: Minor localization problems.

6.3.2

Fixed: Option for automatic refresh did not work in some instances.

6.3.0

Added: Option for automatic refresh. This can be disabled in the blocks advanced settings.
Added: Option to globally disable automatic refresh in the WordPress SimpleTOC settings.

6.2.0

Added: Implemented smooth animation for improved user interaction in the accordion menu.
Added: Upgraded styling of the accordion menu for a more visually appealing and modern user experience.

6.1.0

Fixed: Broken markup when tags closed for headers below minimum. Thanks @harmoney !

6.0.10

Added aria-hidden attribute to icon in accordion. Thanks Alex Stine!

6.0.9

Added ARIA accessibility labels for the accordion. Thanks Amber Hinds!
Fixed: Caching of accordion JavaScript. Thanks jghitchcock!
Added correct ARIA controls attribute.

Klein und Fein

By Burgeule (burgeule) on January 11, 2025

Ich hatte den Button erst gar nicht gefunden / übersehen unter "Blöcke" -> "Design" -> "SimpleTOC".
Klein und fein, wirklich zu empfehlen...

Great plugin that works really well

By Mark Wilkinson (wpmarkuk) on November 5, 2024

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.

Genuinely Great Plugin

By nishantmalik on November 4, 2024

Profile bio appears to be a newly established website that focuses on creating bios for various social media platforms such as Instagram, Facebook, and WhatsApp. The site aims to assist users in crafting concise and engaging personal or professional bios, which are essential for making a good first impression online

Genuinely Great Plugin

By Robert (robertjakobson) on October 20, 2024

I genuinely appreicate the the SimpleTOC plugin - I use it for my site and it fits in seamlessly. It is a great example of a perfect plugin. And I look forward to contributing to its code in a few months.

I have a really bad case of a wonderful domain I got from someone who used it badly and who got that domain semi-blacklisted so I get no SEO traffic at all and SimpleTOC has been one of the highpoints for my users that I get from LinkedIn that in the end result means they stay on average on the page three and a half minutes (3:30+, I think recently it was 3:13 if I excluded suspicious traffic). Some posts get average of five minutes plus.

People underestimate time on site and engagement in general but in particular how a small addition like a table of contents can add to the website and customer experience.

Reliable, it delivers!

By emalassidis on April 21, 2024

Have been using this block for quite a while now. It never failed to deliver.

Works in FSE templates

By Jaroslav "Dero" Polakovic (jpolakovic) on April 17, 2024

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!

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

By Vondelphia.com (vondelphia) on March 27, 2024

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....

Great!

By Ivan Salloum (ivansalloum1) on March 5, 2024

Simple and great plugin! Works very well with the Blocksy theme on the sidebar.

Simply the best TOC (for me)

By Peter Müller (pmmueller) on February 13, 2024

I have tried many different plugins for creating an automated Table of Content, but for the time being I'll stick to this one.

The plugin does everything I need, and if a problem occured it was solved in no time. Marc's support actually deserves more than five stars.

Dank je wel, as we say in the Netherlands 👍🏻

Simple great plugin and support!

By edit4ever on February 12, 2024

What a great and SIMPLE plugin for adding post TOCs to your site. Easy to use customization and they have a very resposive support page!

More Reviews

Alt Text AI – Automatically generate image alt text for SEO and accessibility

Automatically sets the descriptive alt text of your images. Boosts your SEO and accessibility.

Try Demo More Details

Lightweight Accordion

Simple accordion for adding collapse elements to pages without affecting page load time. Includes Gutenberg block and shortcode for classic editor.

Try Demo More Details

Advance Custom HTML – Code editor block for WordPress

An advanced HTML code editor which enable you to code professionally. It provides different skins, denting, correction and more.

Try Demo More Details

SimpleTOC – Table of Contents Block