FAIR

Federated and Independent Repositories

Heroic Table of Contents

Plugin Banner

Heroic Table of Contents

by HeroThemes

Download
Description

WordPress Table of Contents Plugin

Heroic Table of Contents is the easiest way to add a Table of Contents to your site.

A contents or index section allows readers to easily navigate pages on your site. The Heroic Table of Contents block automatically detects headings on a page, 4 built-in-styles, options for display and more.

Features:-

  • Add a contents section to pages in seconds.
  • Choose from 4 pre-made Table of Contents styles.
  • Hide and relabel headings without altering the original content.
  • Choose which headings to display in the Table of Contents.
  • Expand and collapse the content section.
  • Place the contents section anywhere.
  • Choose bulleted, numbered or plain lists
  • Use multiple Table of Contents blocks to break up and sub-index lengthy content.
  • Works with templates and individual posts/pages with Template Mode
  • Automatic template detection with helpful context-aware guidance
  • Mobile friendly
  • SEO friendly

About HeroThemes
HeroThemes develop some of the best WordPress plugins, tools and themes, with over 26,000 customers and counting. If you like this plugin and want more news, themes and plugins, you can do the following:

INSTALL HEROIC TABLE OF CONTENTS FROM WITHIN WORDPRESS

  1. Visit the plugins page within your dashboard and select “Add New”
  2. Search for “Heroic Table of Contents”;
  3. Activate Heroic Table of Contents from your “Plugins” page;
  4. Go to “after activation” below.

INSTALL HEROIC TABLE OF CONTENTS MANUALLY

  1. Upload the unzipped “heroic-toc” folder to your websites /wp-content/plugins/ directory;
  2. Activate the Heroic Table of Contents plugin through the “Plugins” page in WordPress;
  3. Go to “after activation” below.

AFTER ACTIVATION

You can now create a table of contents by adding the Heroic Table of Contents block to your content using the + button in the WordPress block editor.

  1. The Heroic Table of Contents Block adds a Table of Contents section to your content

    The Heroic Table of Contents Block adds a Table of Contents section to your content

  2. Add the Heroic Table of Contents block using the + symbol and selecting it from the editor

    Add the Heroic Table of Contents block using the + symbol and selecting it from the editor

  3. The Table of Contents is automatically generated for headings (H1, H2, H3 etc)

    The Table of Contents is automatically generated for headings (H1, H2, H3 etc)

  4. Includes 4 built in styles, collapsible contents listing and select headings to include/exclude

    Includes 4 built in styles, collapsible contents listing and select headings to include/exclude

  5. Show/hide and relabel headings by clicking on the icons when the block is selected

    Show/hide and relabel headings by clicking on the icons when the block is selected

  6. Choose contents list style

    Choose contents list style

  7. Add custom links to the Table of Contents (beta feature)

    Add custom links to the Table of Contents (beta feature)

Who should use Heroic Table of Contents?

This plugin allows you to add a Contents (Table of Contents, index, page navigation or whatever you want to call it) to your WordPress posts, pages and articles.

Will Heroic Table of Contents work with my theme?

Heroic Table of Contents is designed to work with any WordPress theme.

Is Heroic Table of Contents translation ready?

Yes, Heroic Table of Contents has full translation and localization support.

When should I enable Template Mode?

Enable “Template Mode (Post Content Scope)” when adding the Table of Contents block to post templates, page templates, or custom post type templates. Leave it disabled when adding the block directly to individual posts or pages. Template Mode tells the block to scan for headings within post-content blocks, which is necessary for template-based usage. The plugin will automatically detect if you’re working in a template and show a helpful warning if Template Mode needs to be enabled.

I have a question

Feel free to contact us directly via herothemes.com/contact/ for any questions.

How do I get support?

If you have trouble with the Heroic Table of Contents WordPress plugin, you can get help on the support forums here at wordpress.org or by checking out or knowledge base at herothemes.com/support/.

Fresh & Promising Table of Contents Solution

By TraceMyIP on June 9, 2025

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.

Fantastico!

By recensionivere on October 4, 2022

Index created in seconds with extreme ease.

Perfect

By kamcza on February 1, 2022

Wonderful block for Gutenberg.

Great, lightweight plugin

By Hans-Gerd Gerhards (hage) on August 10, 2021

a great, lightweight plugin that we use on some websites and does what it's supposed to do without any problems. Thanks a lot.

Anchor Titles Behind the Top NavBar

By kingdonkeykong on August 10, 2021

Hi. Would you create a fixing (and put it as an option on the plugin options) to fix the problem of the anchor going to very top of the viewport, but when the page has a top floating navbar, the anchors are hidden by the navbar. I´ve tried to fix it using css, but got no success. May you update it on the next plugin update?

TOC plugin of 2021, hope it supports page breaks

By skillsharejp on May 4, 2021

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.

Gets the job done

By Injabie3 on March 14, 2021

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.

Easy to use and configure

By Deborah Edwards-Onoro (redcrew) on February 24, 2021

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.

The best TOC of plugins

By takuced on November 19, 2020

Very good, simple to use without issue. Can you improve to make it more modern? Here is a small list: - Choice of title position - Choice of anchor style (example: 1 | H2 instead of 1. H2) 1 in black and bold, | in blue then finally H2 in normal, it looks more modern it's just an idea and I saw that in another extension. - Floating pop-up in compact form if we go down the page Thanks for this extension, I hope to see an improvement and I will give you one more star;)

The TOC we've been waiting for.

By Brian Jackson (brianleejackson) on May 29, 2020

I've tried every TOC plugin out there, and none of them get everything perfect. In fact, I just resorted back to doing it manually with the WordPress Block Editor. This takes a little more time but is also the fastest in terms of performance. I'm usually always for getting rid of plugins when possible. However, there are times to weigh the pros and cons. If you are adding a TOC to a majority of posts, this plugin hits the mark in terms of utilizing the Block Editor to its fullest! Click to hide headings you don't want, toggle between styles, open or closed. JS file is 500 B, and the CSS file is only 1KB. Now that's what I'm talking about. With GenerateBlocks, Iceberg, and now this, I'm excited about the future of WordPress and new block plugins. Already a long-time customer of Heroic KB. Keep up the great work guys!

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 properly filtered based on selected levels
(Fixed) Editor styles no longer load on frontend – prevents conflicts with other plugins and WordPress components
(Fixed) Block validation errors when opening posts with older TOC blocks – added proper deprecation handling
(Improved) Proper nested list HTML structure for better accessibility and styling

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) Preview sample content no longer appears on published pages and posts
(Fixed) Block editor validation errors when editing templates
(Improved) Table of Contents now works perfectly on mobile and tablet devices with proper responsive display
(Improved) Renamed Is Single Post to Template Mode (Post Content Scope) with clear descriptive help text
(Improved) Added context-aware guidance to help users know when to enable Template Mode for templates
(Improved) Automatic template detection now shows helpful warning when Template Mode should be enabled
(Improved) Enhanced empty state message with tips for template usage

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

(5 Jun 2025)

(Improved) Post support with sticky Table of Contents
(Updated) Improvements and testing for WordPress 6.8

1.2.2

(22 May 2024)

(Improved) Tweaks and compatibility checking for WordPress 6.5

1.2.1

(19 May 2022)

(Improved) Tweaks and compatibility checking for WordPress 6.0
(Improved) Removed block from non-editor screens where it is not relevant
(Improved) Now supports Reusable blocks

1.2.0

(14 Jul 2021)

(Updated) Improvements and testing for WordPress 5.8

1.1.2

(8 Feb 2021)

(Fixed) Readme.txt formatting

1.1.1

(29 Jan 2021)

(Fixed) Adding missing script.min.js file

1.1.0

(28 Jan 2021)

(Fixed) Semantic HTML markup of the Table of Contents output
(Improved) Optimized scripts and removed jQuery dependencies
(Improved) Math Rank support, SEO for Table of Contents
(Improved) H1 headings are now ignored

1.0.2

(26 Aug 2020)

(Fixed) React warnings in editor
(Improved) Editor styling

1.0.1

(14 Apr 2020)

(Improved) Styling improvements

1.0

(16 Mar 2020)

(New) Initial release

Back to top