Table Of Contents Block
by WPDeveloper · Blocks
Also makes 47 other plugins · 2.8M+ installs across the portfolio →
Add a customizable, SEO-friendly Table of Contents block to WordPress posts & pages — auto-generated from your headings in the Block Editor.
Try it live opens a temporary test site in your browser, which can take about 20 seconds to load. Plugins that rely on outside services or a full server may not work completely there.
Health
B 84/100
Few reviews
Active installs
10K+
≈18K estimated
Momentum
-4%
downloads vs prior 30d
Biggest opportunity: Swap “blocks” and “seo” for “contents” and “table”. “blocks” isn't earning its slot: you're not in the first 24 results for its own search. “contents” sits at #5 untagged, close enough for a declared tag to move it up. “seo” isn't earning its slot: you're not in the first 24 results for its own search. “table” sits at #16 untagged, close enough for a declared tag to move it up. All five slots are taken, so one has to go.
84 health vs 71 average across 2,531 Blocks plugins
Install conversion
How it's measured →8.8%
of downloads still active
At least 10K of 113.7K lifetime downloads are still running, above its category: the median Blocks plugin keeps 2.1%, across 1,583 plugins.
Downloads count every update, not just first installs, so older and more frequently released plugins read lower. Compare against other Blocks plugins, not across the directory. wp.org reports active installs as the bottom of a band, so the real rate is this or higher.
This plugin shipped 3 releases in the last 12 months, and every existing install that updated counted as another download. wp.org publishes no split between first installs and updates, so we show the raw rate rather than guess at one.
Details
Directory ranking optimization
How it's scored →How well this listing is tuned to rank in WordPress.org search, on the factors an owner controls. Not popularity, optimization.
Excellent listing optimization
Most to gain: Rating quality
Updated 7 days ago
Tested up to WordPress 7.1.4, the current branch or newer
4.3★ over 7 reviews, weighted for review count to 4.1★ and held back under 25 reviews
5 of 5 tags set · short description in place
1 of 1 support threads resolved in the last 2 months
To rank higher: Too few reviews to rank on quality — nudge happy users to leave one.
Get the full rank-higher report →Search visibility
How it's tracked →Directory searches this plugin turns up in, and which way each one is moving. WordPress.org publishes no history of search positions, so this starts the day we first tracked a keyword and never backfills.
36
Momentum
Losing ground
-0.5
Velocity
places per keyword, 28d
17%
Breadth
of keywords climbing, 28d
-0.5
Acceleration
recent half vs earlier
wp.org is where the directory puts the plugin for that search. On merit is where it would sit if results were ranked on rating, support and updates, without the install boost. The last column is how far the wp.org position moved, from our first reading in the last 90 days to the latest.
| Keyword | wp.org | On merit | wp.org move, 90 days |
|---|---|---|---|
| table of contents block | #3 | #16 | 0 |
| table of contents your tag | #4 | #18 | up 1 |
| contents | #5 | #19 | down 1 |
| best table of contents | #2 | #12 | 0 |
| toc block | #2 | #7 | down 1 |
| toc your tag | #6 | #15 | up 3 |
| auto table of contents | #3 | #14 | 0 |
| table of content block | #4 | #19 | down 1 |
| wordpress table of contents | #5 | #21 | 0 |
| auto table scroll | #5 | #21 | down 1 |
| block table | #5 | #18 | 0 |
| table block | #5 | #17 | 0 |
| table | #16 | #22 | up 5 |
| generated | #17 | #23 | 0 |
| headings | #20 | #20 | 0 |
| advanced toc | #8 | #18 | down 1 |
| post toc | #8 | #17 | 0 |
| block | #24 | #23 | down 1 |
| ip block | #9 | #15 | 0 |
| wordpress toc | #9 | #16 | 0 |
| blocks your tag | Not in the top 24 | ||
| gutenberg your tag | Not in the top 24 | ||
| seo your tag | Not in the top 24 | ||
207 searches this plugin appeared in over the last 90 days, 20 listed. 169 left out as unrelated or noise (years, numbers, stray words). 3 of its tags aren't in the top 24 for their own search.
What to do about it
- Swap “blocks” and “seo” for “contents” and “table”. “blocks” isn't earning its slot: you're not in the first 24 results for its own search. “contents” sits at #5 untagged, close enough for a declared tag to move it up. “seo” isn't earning its slot: you're not in the first 24 results for its own search. “table” sits at #16 untagged, close enough for a declared tag to move it up. All five slots are taken, so one has to go.
Daily downloads
Since 5 Oct 2022 · 1,491 days · wp.org + Plugin Pulse archive
30-day downloads
Rolling 30-day volume · peak 9.9K · peaks are release surges
Directory rank vs rivals
wp.org popularity rank over time · higher is better · when a rival's line climbs above yours, they've overtaken you
Rating trend
Star average over time · dips mark rough releases
Health trend
Composite health score, snapshotted daily
Update activity
How busy the existing users are, measured as downloads in the last 30 days for every 1,000 active sites. A spike means a new release everyone's pulling; a long, slow decline means an aging user base that updates less.
Release cadence
Occasionally updatedHow often this plugin actually ships. A steady rhythm is the maintenance signal a single "last updated" date can't show.
3
releases in the last 12 months
7d ago
latest release · v1.5.2 · 27 Oct 2026
16
tagged releases on record
Recent releases
What its installed base runs
via wordpress.orgShare of active installs on each version of this plugin. Green is the current release; a big slice on older versions is a user base that has stopped updating.
Estimated active installs
The public count shows “10K+”. Our estimate pins where the real number sits.
Crossed into this band 2.3 years ago; a band this size takes about a year or more to cross, which places it about 80% of the way through.
Install history since 13 Apr 2021
Recent reviews
All reviews on wp.org ↗- ★★★★★ Clicknathan1.5y ago
Gutenberg / the block editor already adds enough bloat. This plugin contributes even more to that, adding at least 4 stylesheets. “SimpleTOC – Table of Contents Block” by Marc Tönsing does a much better job, in my opinion. This plugin does have a lot of nifty options, that those of you not concerned about your site’s performance may be interested in having.
Read on wp.org ↗ - ★★★★★ Bookman534.2y ago
I had a small CSS-related issue with the plugin, but the developer very quickly sent an update to correct it. Great support!
Read on wp.org ↗ - ★★★★★ Denys Storoniak4.2y ago
Started to use it like an hour ago, works well. The only thing it missing, that comes to my mind, is an option for ‘Scroll To Top’ arrow — ‘Scroll to Table of Contents’. It would be perfect if devs would add it 🙂
Read on wp.org ↗ - ★★★★★ bklassenabb4.4y ago
Perfect – now I have a clickable TOC on my page. The only thing it’s missing is anchor tags for deep linking.
Read on wp.org ↗ - ★★★★★ algebrasoft4.8y ago
It finds automatically finds a heading and compiles it into TOC, But if the heading starts with a number (i.e for example if I have 2 content in a table 1. banana 2. orange or like 1Banana 2orange or 1)banana 2)orange ) it discovers the headings but it doesn’t link to that specific section. N.B This happens regardless of TOC’s style whether it is numbered list or not, if your heading has a number at start it occurs This topic was modified 4 years, 5 months ago by algebrasoft.
Read on wp.org ↗ - ★★★★★ Martin Sauter5.0y ago
I just needed a block with a table of contents for my longer blog articles. This plugin delivers exactly that: It finds all the headings in the article and compiles them automatically as a TOC with links to these headings. The TOC is highly customizable through the block settings, however I prefer to style it through my global CSS stylesheet which delivers a consistent look and feel for all my TOC. Very nice!
Read on wp.org ↗ - ★★★★★ technicalx5.7y ago
can’t get it working, looks ok
Read on wp.org ↗
Latest updates
via wp.org changelogRecent releases and news for this plugin
- — Version 1.4.1 Fixed: compatibility support with wordpress 6.5 version Improved: Security enhancement Improved: controls 1.4.1
- — Version 1.4.0 Added: New preset for Table of Contents Block Fixed: Special Character issue in Table of Content block headings Fixed: Table of Content block warnings with PHP 8.2 or higher Improved: Table of Contents block multiple req 1.4.0
- — Version 1.3.6 Fixed: style enqueue issue 1.3.6
- — Version 1.3.5 Added: Table of Content link copy button Added: Table of Content block support All Heading blocks Added: Heading exclude option in Table of Content block Fixed: Table of Content block doesn’t work inside wrapper/group bl 1.3.5
- — Version 1.3.4 Fixed: Minor bugs Improved: Update controls 1.3.4
- — Version 1.3.3 Added: Scroll to TOC position option Added: Added TOC sticky position option 1.3.3
Security history
via Wordfence IntelligenceThe 1 disclosed vulnerability is patched in the current version (1.5.2). Sites still on an older version should update.
- Patched Medium · 6.4 Table Of Contents Block <= 1.5.0 - Authenticated (Contributor+) Stored Cross-Site Scripting ↗2026-08-18 CVE-2026-66645 Improper Neutralization of Input During Web Page Generation Affects <= 1.5.0 Patched in 1.5.1
Vulnerability records provided by Wordfence Intelligence. Copyright 2012-2026 Defiant Inc. License and terms.
CVE records: Copyright 1999-2026 The MITRE Corporation. CVE terms of use.
Languages
via translate.wordpress.orgTranslated into 4 languages, 2 at 90% or more
AI assistants
How it's measured →Whether ChatGPT and Claude name this plugin when asked the category question, and whether the readme gives them something to quote.
Share of voice
How often each assistant names Table Of Contents Block when asked about this topic, where it comes in the answer, and how that compares with its wp.org search position. Latest run 1 Nov 2026.
- Assistants
- ChatGPT, Claude
- Topics tracked
- Table of contents
Readme readiness
7 of 8 pass · checked 28 Oct 2026Can an assistant quote this readme? Eight deterministic checks over the wp.org listing, no model involved.
- ✓ Says what it does "Add a customizable, SEO-friendly Table of Contents block to WordPress posts & pages — auto-generated from y..."
- ✓ Has a FAQ 6 questions in the FAQ.
- ✓ FAQ asks real questions 6 of 6 read like questions a user would type.
- ! Names who it is for One audience phrase ("if you have"); say who the plugin is for and what they use it for.
- ✓ Names what it works with Mentions WooCommerce, Elementor, Gutenberg, Block editor and 3 more.
- ✓ Headings and lists 6 headings and 3 lists.
- ✓ Enough to quote 3,813 characters of description.
- ✓ Tags match the text All 5 tags appear in the text.
Growth timeline
Install-tier crossings we have observed, and how long each tier took to outgrow
- 2024-07-09 9K+ → 10K+ up after 137 days in tier
- 2024-02-23 8K+ → 9K+ up after 100 days in tier
- 2023-11-15 7K+ → 8K+ up after 92 days in tier
- 2023-08-15 6K+ → 7K+ up after 72 days in tier
- 2023-06-04 5K+ → 6K+ up after 100 days in tier
- 2023-02-24 4K+ → 5K+ up after 100 days in tier
- 2022-11-16 3K+ → 4K+ up after 52 days in tier
- 2022-09-25 2K+ → 3K+ up after 214 days in tier
Competes with
The plugins that solve the same job, ranked by shared tags then reach, closest match first. The letter on the right is each plugin's health grade (A best, F worst).
-
LuckyWP Table of Contents 90K+ installs · 4.9★ · 3 shared tags B -
Heroic Table of Contents 5K+ installs · 4.3★ · 3 shared tags A -
Easy Table of Contents 600K+ installs · 4.3★ · 2 shared tags B -
Table of Contents Plus – Automatic Table of Contents for Posts & Pages 200K+ installs · 4.4★ · 2 shared tags A -
Rich Table of Contents 20K+ installs · 4.0★ · 2 shared tags C -
SimpleTOC – Table of Contents Block 10K+ installs · 4.8★ · 2 shared tags A
Embed this report card
Drop a live Pulse card for Table Of Contents Block into a readme, a review or a deck. It updates itself.
<iframe src="https://plugins.wpmayor.com/embed/table-of-contents-block" width="480" height="300" style="border:0" loading="lazy" title="Table Of Contents Block — Plugin Pulse"></iframe> Table Of Contents Block: 10K+ active installs, 4.3★ (7 reviews). Plugin Pulse (WP Mayor), as of 2026-11-03. https://plugins.wpmayor.com/plugin/table-of-contents-block
Spotted a number that looks wrong? Report a data issue and we'll check it against the source.