Heroic Table of Contents
by HeroThemes · SEO
Also makes 2 other plugins · 14K+ installs across the portfolio →
Heroic Table of Contents is the easiest way to add a table of contents to your site.
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
A 86/100
no flags
Active installs
5K+
≈5.7K estimated
Momentum
+29%
downloads vs prior 30d
Biggest opportunity: Swap “navigation”, “seo” and “index” for “contents”, “table” and “easiest”. “navigation” isn't earning its slot: you're not in the first 24 results for its own search. “contents” sits at #6 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 #13 untagged, close enough for a declared tag to move it up. “index” isn't earning its slot: it only gets you to #20. “easiest” sits at #14 untagged, close enough for a declared tag to move it up. All five slots are taken, so one has to go.
86 health vs 66 average across 2,241 SEO plugins
Install conversion
How it's measured →6.9%
of downloads still active
At least 5K of 72.7K lifetime downloads are still running, above its category: the median SEO plugin keeps 1.2%, across 1,198 plugins.
Downloads count every update, not just first installs, so older and more frequently released plugins read lower. Compare against other SEO 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 50 days ago
Tested up to WordPress 7.1.4, the current branch or newer
4.7★ over 10 reviews, weighted for review count to 4.2★ 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.
41
Momentum
Losing ground
-0.2
Velocity
places per keyword, 28d
27%
Breadth
of keywords climbing, 28d
-0.1
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 |
|---|---|---|---|
| contents | #6 | #16 | down 1 |
| table of contents your tag | #6 | #15 | down 1 |
| best table of contents | #3 | #9 | up 1 |
| toc your tag | #9 | #10 | down 1 |
| wordpress table of contents | #4 | #10 | 0 |
| table | #13 | #19 | up 1 |
| easiest | #14 | #20 | up 1 |
| table of contents block | #6 | #15 | down 1 |
| index your tag | #20 | #19 | down 1 |
| post toc | #13 | #16 | 0 |
| wordpress toc | #13 | #13 | down 1 |
| wordpress table | #15 | #23 | down 3 |
| page contents | #16 | #20 | up 2 |
| wordpress contents | #19 | #23 | 0 |
| custom contents | #20 | #22 | up 1 |
| table plugins | #21 | #22 | up 3 |
| table plugin | #21 | #22 | up 1 |
| custom table | #21 | #23 | down 2 |
| no index | #22 | #21 | up 2 |
| post table | #22 | #23 | down 2 |
| navigation your tag | Not in the top 24 | ||
| seo your tag | Not in the top 24 | ||
91 searches this plugin appeared in over the last 90 days, 20 listed. 71 left out as unrelated or noise (years, numbers, stray words). 2 of its tags aren't in the top 24 for their own search.
What to do about it
- Swap “navigation”, “seo” and “index” for “contents”, “table” and “easiest”. “navigation” isn't earning its slot: you're not in the first 24 results for its own search. “contents” sits at #6 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 #13 untagged, close enough for a declared tag to move it up. “index” isn't earning its slot: it only gets you to #20. “easiest” sits at #14 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 5.2K · 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
2mo ago
latest release · v1.3.2 · 14 Sep 2026
15
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 “5K+”. Our estimate pins where the real number sits.
Crossed into this band 9 months ago; the previous band took 3 years to cross, which places it about 74% of the way through.
Install history since 1 Oct 2020
Recent reviews
All reviews on wp.org ↗- ★★★★★ TraceMyIP1.4y ago
This is a breath of fresh air and feels actively maintained and loved. The automatic heading detection works like magic, and having 4 built-in styles saves tons of design time. Really appreciate being able to hide/relabel headings without touching the original content – that’s smart! The expand/collapse feature is perfect for long posts. While it’s still growing (6k installs), the recent updates and stellar reviews suggest HeroThemes is committed to making this a winner.
Read on wp.org ↗ - ★★★★★ recensionivere4.1y ago
Index created in seconds with extreme ease.
Read on wp.org ↗ - ★★★★★ testwp754.7y ago
i don’t know why my review has been delete, but this is a very bad plugin actually
Read on wp.org ↗ - ★★★★★ kamcza4.8y ago
Wonderful block for Gutenberg.
Read on wp.org ↗ - ★★★★★ Hans-Gerd Gerhards5.2y ago
a great, lightweight plugin that we use on some websites and does what it’s supposed to do without any problems. Thanks a lot. This topic was modified 4 years, 11 months ago by Hans-Gerd Gerhards.
Read on wp.org ↗ - ★★★★★ skillsharejp5.5y ago
I needed a Gutenberg friendly TOC plugin for my elearning site, and this is working almost perfectly. One more feature I need is, support for multiple pages using WP’s page break feature. Designs are way better than TOC+ and other major TOC plugins. This topic was modified 5 years, 2 months ago by skillsharejp.
Read on wp.org ↗ - ★★★★★ Injabie35.6y ago
Works as intended if a blog post is a single page. If it’s split across multiple pages, the anchors on subsequent pages don’t work because they expect them all to be in the same page as opposed to a single page.
Read on wp.org ↗ - ★★★★★ Deborah Edwards-Onoro5.7y ago
For my academic client, I needed to find an easy-to-use and customizable table of contents plugin with automatic table of contents creation based on headings. Heroic Table of Contents worked wonderfully, allowing me to quickly add a TOC and customize the layout. I love that the plugin automatically updates the TOC when the headings change.
Read on wp.org ↗
Latest updates
via wp.org changelogRecent releases and news for this plugin
- — Version 1.2.7 (7 Jan 2026) (Fixed) Customizer compatibility with certain third party themes – ToC JavaScript skipped in Customizer while CSS remains for proper styling 1.2.7
- — Version 1.2.6 (17 Nov 2025) (Fixed) Table of Contents submenus now automatically collapse and expand based on scroll position in post mode (Fixed) Scan levels (heading selection H1-H6) now work correctly on the frontend – headings are 1.2.6
- — Version 1.2.5 (26 Oct 2025) (Fixed) Table of Contents now displays correctly on your live site without editor buttons or preview content showing (Fixed) Text size in the Table of Contents now appears correctly on the frontend (Fixed) 1.2.5
- — Version 1.2.4 (16 Oct 2025) (Fixed) Site editor preview mode now correctly displays sample content for post templates (Fixed) Console warning about CSS being added to iframe incorrectly (Improved) Post support with Update Font Size 1.2.4
- — Version 1.2.3 (5 Jun 2025) (Improved) Post support with sticky Table of Contents (Updated) Improvements and testing for WordPress 6.8 1.2.3
- — Version 1.2.2 (22 May 2024) (Improved) Tweaks and compatibility checking for WordPress 6.5 1.2.2
Languages
via translate.wordpress.orgTranslated into 7 languages, 5 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 Heroic Table of Contents 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
6 of 8 pass · checked 3 Nov 2026Can an assistant quote this readme? Eight deterministic checks over the wp.org listing, no model involved.
- ✓ Says what it does "Heroic Table of Contents is the easiest way to add a table of contents to your site."
- ✓ 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 Never says who the plugin is for or what they use it for.
- ✓ Names what it works with Mentions Facebook, Twitter.
- ! Headings and lists 1 heading and 2 lists; assistants quote headed sections and bullet lists, not paragraphs.
- ✓ Enough to quote 1,418 characters of description.
- ✓ Tags match the text 3 of 5 tags appear in the text; "navigation", "toc" do not.
Growth timeline
Install-tier crossings we have observed, and how long each tier took to outgrow
- 2026-01-28 6K+ → 5K+ down after 1090 days in tier
- 2023-02-03 5K+ → 6K+ up after 122 days in tier
- 2022-10-04 4K+ → 5K+ up after 169 days in tier
- 2022-04-18 3K+ → 4K+ up after 115 days in tier
- 2021-12-24 2K+ → 3K+ up after 250 days in tier
- 2021-04-18 600+ → 2K+ up
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★ · 4 shared tags B -
Joli Table Of Contents – Table of Contents with Gutenberg Block & Shortcode 7K+ installs · 4.7★ · 4 shared tags A -
Table of Contents Plus – Automatic Table of Contents for Posts & Pages 200K+ installs · 4.4★ · 3 shared tags A -
Rich Table of Contents 20K+ installs · 4.0★ · 3 shared tags C -
Table Of Contents Block 10K+ installs · 4.0★ · 3 shared tags B -
F70 Simple Table of Contents 100+ installs · 4.1★ · 3 shared tags B
Embed this report card
Drop a live Pulse card for Heroic Table of Contents into a readme, a review or a deck. It updates itself.
<iframe src="https://plugins.wpmayor.com/embed/heroic-table-of-contents" width="480" height="300" style="border:0" loading="lazy" title="Heroic Table of Contents — Plugin Pulse"></iframe> Heroic Table of Contents: 5K+ active installs, 4.7★ (10 reviews). Plugin Pulse (WP Mayor), as of 2026-11-03. https://plugins.wpmayor.com/plugin/heroic-table-of-contents
Spotted a number that looks wrong? Report a data issue and we'll check it against the source.