SimpleTOC – Table of Contents Block


In Gutenberg, add a block and search for “SimpleTOC” or just “TOC”. You need to save your post before you add the block. It works by parsing the post content and retrieving the heading blocks and creates a new dynamic block with a list of links to the headings.


  • Designed for Gutenberg.
  • Compatible with AMP plugins.
  • Minimal and valid HTML output.
  • Inherits the style of your theme.
  • Control the maximum depth of the headings.
  • SEO friendly: Disable the h2 heading of the TOC block and add your own.
  • No javascript or css added.
  • Comes with English, French, Spanish, German, and Brazilian Portuguese translations.
  • Rank Math support.

This plugin is forked from by pdewouters and uses code from by shazahm1

Many thanks to Tom J Nowell and and Sally CJ who both helped me a lot with my questions over at


  • SimpleTOC block in Gutenberg editor.
  • SimpleTOC in the post.
  • Disable "Table of contents" block headings´.
  • Control the maximum depth of the headings.


This plugin provides 1 block.

  • SimpleTOC - Table of Contents Block


SimpleTOC can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from and installed manually…

In Gutenberg, add a block and search for “SimpleTOC” or just “TOC”. Please save your content before you use the block.


جنوری 12, 2021
Glad i found this plugin, not only does it work on AMP pages it does not load CSS/JS unlike what i previously used. Thanks for this great plugin.
جنوری 6, 2021
Most others offer Classic and gutenberg options. I just needed Gutenberg block which would automatically create anchor tags. This works perfect. Now Rankmath recognizes it. Thank you
جنوری 3, 2021
Exactly what I was after. A simple table of contents plugin that's AMP compatible. Thanks for the great work! Nathan
جنوری 2, 2021
The plugin is excellent, it is the only free plugin that supports AMP. In addition, the developer does a good job in developing the plugin.
Read all 9 reviews

Contributors & Developers

“SimpleTOC – Table of Contents Block” is open source software. The following people have contributed to this plugin.


“SimpleTOC – Table of Contents Block” has been translated into 7 locales. Thank you to the translators for their contributions.

Translate “SimpleTOC – Table of Contents Block” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fix: HTML entites are properly decoded before anchor attribute is added. This removes encoding problems and questionmark characters in headlines.


  • Feature: Experimental support for Arabic Text.


  • Added option to set maximum level of the headings.


  • Option to disable block heading added.
  • Enhanced the localization strings.
  • Added Brazilian Portuguese translations to the translations. Thanks Ralden Souza!


  • Added support for Rank Math plugin.