SimpleTOC - Table of Contents Block
by Marc Tönsing 4.9 (77 reviews)

SimpleTOC - Table of Contents Block

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

SimpleTOC ranks #1,467 among WordPress.org plugins with 10,000+ active installations, is #67 of 1,143 in the Editor & Writing category, a 4.9/5 rating from 77 reviews, and was last updated Aug 22, 2026. Data from WordPress.org, refreshed twice daily — see methodology.

Compatible with WP 7.1
v7.3.0 Current Version v7.3.0
Updated 3 weeks ago Last Update on 22 Aug, 2026
Refreshed 10 hours ago Last Refreshed on
#67 of 1,143 in Editor & Writing Top 5% by installs Downloads -35% this week Actively maintained
View on WordPress.org
Rank
#1,467
No change
Active Installs
10K+
-47.8%
KW Avg Position
39.6
0.2 better
Downloads
526.1K
+126 today
Support Resolved
100%
No change
Rating
98%
Review 4.9 out of 5
4.9 (77 reviews)

Next Milestone 20K

Total Progress 94.3%
10K+ 20K+
46
Ranks to Climb
-
Growth Needed
8,000,000
Active Installs
Pro

Unlock Exact Install Count

See the precise estimated active installs for this plugin, calculated from real-time ranking data.

  • Exact install estimates within tiers
  • Track install growth over time
  • Milestone progress predictions
Upgrade to Pro
Need 575 more installs to reach 20K+

Rank Changes

1,394 1,432 1,471 1,510 1,548 09-09-2026 10-09-2026 11-09-2026 12-09-2026 13-09-2026 14-09-2026 15-09-2026 16-09-2026
1,462 1,469 1,475 1,482 1,488 01-09-2026 02-09-2026 03-09-2026 04-09-2026 05-09-2026 06-09-2026 07-09-2026 08-09-2026 09-09-2026 10-09-2026 11-09-2026 12-09-2026 13-09-2026 14-09-2026 15-09-2026 16-09-2026
Current #1,467
Change
Best #

Upgrade to Pro

Unlock 30-day and 90-day rank history charts with a Pro subscription.

Upgrade Now

Active Installs Growth

Active Installs 0,000,000+
Growth +0.0%
Peak 0,000,000

Downloads Growth

0 100 200 09-09-2026 10-09-2026 11-09-2026 12-09-2026 13-09-2026 14-09-2026 15-09-2026 16-09-2026
50 100 150 200 250 01-09-2026 02-09-2026 03-09-2026 04-09-2026 05-09-2026 06-09-2026 07-09-2026 08-09-2026 09-09-2026 10-09-2026 11-09-2026 12-09-2026 13-09-2026 14-09-2026 15-09-2026 16-09-2026
Downloads
Growth
Peak

Upgrade to Pro

Unlock 30-day, 90-day, and yearly download history charts with a Pro subscription.

Upgrade Now

Reviews & Ratings

4.9
77 reviews
Overall 98%
5
73 (95%)
4
4 (5%)
3
0 (0%)
2
0 (0%)
1
0 (0%)

Support Threads Overview

Resolved
Unresolved
1
Total Threads
1
Resolved
0
Unresolved
100%
Resolution Rate

Security History

Source: WPVulnerability

No known vulnerabilities on record for SimpleTOC. Checked 1 week ago.

TL;DR

AI summary of the plugin's readme

This plugin is for WordPress site owners and content creators using the Gutenberg editor who want a table of contents on their posts and pages. It solves the problem of manually building navigable headings lists by auto-generating a nested list of links to a post's headings with configurable depth and styling.

  • Zero configuration setup
  • No JavaScript or CSS by default
  • Collapsible interface via details tag
  • Optional box style
  • Smooth scrolling effect
  • Control maximum heading depth
  • Ordered or bullet list options
  • GeneratePress and Rank Math support

Frequently Asked Questions

Common questions about SimpleTOC - Table of Contents Block

Select the SimpleTOC block and open Gutenberg's Styles tab. Choose the Box style or use the native color controls to set text, link, and background colors. Native spacing controls are available for vertical margins and padding.
If you really want to hide a single heading from the table of contents, then add the CSS class "simpletoc-hidden" to a heading block. You can find this field in the same place as the HTML anchor field: In the Block > Advanced sidebar. But first, think about the reason you would like to hide a specific heading. Maybe you would like to remove all headings of a specific depth level. Then there is an option for that in the blocks options in Gutenberg. If you think this heading should not be part of the toc perhaps it is not needed in the post itself?
You can convert your configured SimpleTOC block into a reusable block in Gutenberg. It will keep its settings. This way, you can use your desired settings for each new post by adding the reusable block.
Add styles for the simpletoc/toc block to your theme.json. SimpleTOC uses the standard Gutenberg block wrapper and supports native colors, vertical margins, padding, font size, and line height settings. The following example sets default colors, spacing, and typography for every SimpleTOC block: { "$schema": "https://schemas.wp.org/trunk/theme.json", "version": 3, "styles": { "blocks": { "simpletoc/toc": { "color": { "background": "#f5f5f5", "text": "#1e1e1e" }, "elements": { "link": { "color": { "text": "#0057b8" } } }, "spacing": { "margin": { "top": "1.5rem", "bottom": "1.5rem" }, "padding": { "top": "1rem", "right": "1rem", "bottom": "1rem", "left": "1rem" } }, "typography": { "fontSize": "1rem", "lineHeight": "1.6" } } } } } Replace the example values with your theme's values or preset variables. Selecting the Box style adds the standard is-style-boxed class.
Use the 'simpletoc_excluded_blocks' filter. For example, this code will exclude heading blocks that are inside a column block. Example: add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) { $blocks[] = 'core/column'; return $blocks; } );
The heavy plus character I used can not be colored with css without hacks. But you can change the icon to something else and change the color of the new icon. .simpletoc-collapsible::after { content: "✖"; color: #e94c89; }
I don’t see an easy solution at the moment. SimpleTOC is only a block that can be placed in your post. If there was a plugin that adds blocks to every post, then this would be the solution. I think this should be another separate plug-in to keep the code of SimpleTOC clean and … well, simple.

Sign In / Register

You need to sign in or register to use this feature.