Title: Heroic Table of Contents Author: HeroThemes Published: مارس 16, 2020 Last modified: سپتامبر 14, 2026 --- Search plugins ![](https://ps.w.org/heroic-table-of-contents/assets/banner-772x250.png?rev=2261757) ![](https://ps.w.org/heroic-table-of-contents/assets/icon.svg?rev=2261757) # Heroic Table of Contents By [HeroThemes](https://profiles.wordpress.org/herothemes/) [Download](https://downloads.wordpress.org/plugin/heroic-table-of-contents.1.3.2.zip) * [Details](https://haz.wordpress.org/plugins/heroic-table-of-contents/#description) * [Reviews](https://haz.wordpress.org/plugins/heroic-table-of-contents/#reviews) * [Installation](https://haz.wordpress.org/plugins/heroic-table-of-contents/#installation) * [Development](https://haz.wordpress.org/plugins/heroic-table-of-contents/#developers) [Support](https://wordpress.org/support/plugin/heroic-table-of-contents/) ## Description #### WordPress Table of Contents Plugin [Heroic Table of Contents](https://herothemes.com/plugins/heroic-table-of-contents/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc) 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](https://herothemes.com/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc) > 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: > * Get the [KnowAll Knowledge Base theme for WordPress](https://herothemes.com/themes/knowall-wordpress-knowledge-base/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc), > create a WordPress powered knowledge base site in minutes. > * Check out the [best WordPress Knowledge Base plugin](https://herothemes.com/plugins/heroic-wordpress-knowledge-base/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc). > * Answer Frequently Asked Questions with [Heroic FAQs plugin for WordPress](https://herothemes.com/plugins/wordpress-faq-plugin/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc). > * Follow HeroThemes on [Twitter](https://twitter.com/herothemes) & [Facebook](https://www.facebook.com/herothemes). ## Screenshots [⌊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⌉[ The Heroic Table of Contents Block adds a Table of Contents section to your content [⌊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⌉[ Add the Heroic Table of Contents block using the + symbol and selecting it from the editor [⌊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)⌉[ The Table of Contents is automatically generated for headings (H1, H2, H3 etc) [⌊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⌉[ Includes 4 built in styles, collapsible contents listing and select headings to include/exclude [⌊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⌉[ Show/hide and relabel headings by clicking on the icons when the block is selected [⌊Choose contents list style⌉⌊Choose contents list style⌉[ Choose contents list style [⌊Add custom links to the Table of Contents (beta feature)⌉⌊Add custom links to the Table of Contents (beta feature)⌉[ Add custom links to the Table of Contents (beta feature) ## Installation ### 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. ## FAQ ### 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/](https://herothemes.com/contact/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc) 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](https://wordpress.org/support/plugin/heroic-table-of-contents/) or by checking out or knowledge base at [herothemes.com/support/](https://herothemes.com/support/?utm_source=wprepo&utm_medium=link&utm_campaign=heroic-toc). ## Reviews ![](https://secure.gravatar.com/avatar/dcf3ac4816daefacc712cea4e40d63b706a71b652ed2466b61d58592c9816e67? s=60&d=retro&r=g) ### 󠀁[automatic yet customizable links are great](https://wordpress.org/support/topic/automatic-yet-customizable-links-are-great/)󠁿 [wp_poole](https://profiles.wordpress.org/wp_poole/) سپتامبر 18, 2026 We use the Heroic TOC blocks across our site and the automatically populated links make setup fast while being able to customize those, or add new links are essential functionalities in the cases where we need to fine tune. This is the way TOC work best and the plugin is well designed and regularly updates. Support is reponsive too, if you ever have questions. Well done Heroic! ![](https://secure.gravatar.com/avatar/cc2a9cd5e4097876802a40afc3f0865a84fa3c9d2c2caa6c789218fe9ae52b2f? s=60&d=retro&r=g) ### 󠀁[Fresh & Promising Table of Contents Solution](https://wordpress.org/support/topic/fresh-promising-table-of-contents-solution/)󠁿 [TraceMyIP](https://profiles.wordpress.org/tracemyip/) ژوئن 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. ![](https://secure.gravatar.com/avatar/6f8fa934106c78709a545b3d245f746850794b5c0e0e9b01378e450725140433? s=60&d=retro&r=g) ### 󠀁[Fantastico!](https://wordpress.org/support/topic/fantastico-305/)󠁿 [recensionivere](https://profiles.wordpress.org/recensionivere/) اکتبر 4, 2022 Index created in seconds with extreme ease. ![](https://secure.gravatar.com/avatar/184f41c0137defb56ae7b948a45b45a6028c73da5bb2022cc96501c3d2f3816a? s=60&d=retro&r=g) ### 󠀁[Perfect](https://wordpress.org/support/topic/perfect-9076/)󠁿 [kamcza](https://profiles.wordpress.org/kamcza/) فوریه 1, 2022 2 replies Wonderful block for Gutenberg. ![](https://secure.gravatar.com/avatar/ab62eb42e842b6adca897024806bbf5eaebe9896ac46f2d6823973e6d9d27d42? s=60&d=retro&r=g) ### 󠀁[Great, lightweight plugin](https://wordpress.org/support/topic/great-lightweight-plugin-18/)󠁿 [Hans-Gerd Gerhards](https://profiles.wordpress.org/hage/) آگوست 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. ![](https://secure.gravatar.com/avatar/b6bee5ed9e82d7d0e7d94714317dcdcc7b62b53141879256f50b89c9ce8a5c92? s=60&d=retro&r=g) ### 󠀁[Anchor Titles Behind the Top NavBar](https://wordpress.org/support/topic/anchor-titles-behind-the-top-navbar/)󠁿 [kingdonkeykong](https://profiles.wordpress.org/kingdonkeykong/) آگوست 10, 2021 3 replies 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? [ Read all 10 reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/) ## Contributors & Developers “Heroic Table of Contents” is open source software. The following people have contributed to this plugin. Contributors * [ HeroThemes ](https://profiles.wordpress.org/herothemes/) * [ Richard Long ](https://profiles.wordpress.org/richardlong/) * [ Chris Hadley ](https://profiles.wordpress.org/chrishadley/) “Heroic Table of Contents” has been translated into 5 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/heroic-table-of-contents/contributors) for their contributions. [Translate “Heroic Table of Contents” into your language.](https://translate.wordpress.org/projects/wp-plugins/heroic-table-of-contents) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/heroic-table-of-contents/), check out the [SVN repository](https://plugins.svn.wordpress.org/heroic-table-of-contents/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/heroic-table-of-contents/) by [RSS](https://plugins.trac.wordpress.org/log/heroic-table-of-contents/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.3.2 (14 Sep 2026) (Fixed) Editing a Table of Contents entry now opens the field pre-filled with the current label instead of an empty box; Enter saves, the trash icon reverts to the heading text (Fixed) Removed the stray border drawn around the entry edit / show- hide controls in the block editor #### 1.3.1 (14 Sep 2026) (Fixed) The edit, show/hide, delete and add-custom-link controls on Table of Contents entries were invisible in the WordPress 7.x block editor (rendered as empty boxes); they now use inline icons with a visible border and background #### 1.3.0 (14 Sep 2026) (Fixed) WordPress 7.x compatibility: core block editor controls (block “+” appenders, Columns layout picker, Image/media placeholder buttons) were hidden inside the editor canvas while the plugin was active (Fixed) Site Editor navigation menus: the “+” add-item button is visible again (Fixed) Nested headings (H3, H4 and below) are shown again in the Table of Contents on ordinary posts and pages; automatic collapsing now only applies in Template Mode where it follows the scroll position (Fixed) Inserting a new block could fail with a JSON parse error; entry data is now parsed defensively( Fixed) Editor stylesheets are now added to the block editor canvas the intended way, removing the “stylesheet added to the iframe incorrectly” warning (Improved) Inline entry controls (edit, show/hide, add custom link) and the list style toolbar updated to current block editor components, removing deprecation warnings (Improved) Frontend assets load only on pages that contain the block (Improved) Hardened link handling and label escaping in the Table of Contents output (Improved) Tested with WordPress 7.1 #### 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.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 ## Meta * Version **1.3.2** * Last updated **3 هفته ago** * Active installations **5,000+** * WordPress version ** 6.7 or higher ** * Tested up to **7.1.3** * PHP version ** 8.0 or higher ** * Languages * [Chinese (China)](https://cn.wordpress.org/plugins/heroic-table-of-contents/), [Dutch](https://nl.wordpress.org/plugins/heroic-table-of-contents/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/heroic-table-of-contents/), [English (US)](https://wordpress.org/plugins/heroic-table-of-contents/), [French (France)](https://fr.wordpress.org/plugins/heroic-table-of-contents/), and [German](https://de.wordpress.org/plugins/heroic-table-of-contents/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/heroic-table-of-contents) * Tags * [index](https://haz.wordpress.org/plugins/tags/index/)[navigation](https://haz.wordpress.org/plugins/tags/navigation/) [seo](https://haz.wordpress.org/plugins/tags/seo/)[table of contents](https://haz.wordpress.org/plugins/tags/table-of-contents/) [toc](https://haz.wordpress.org/plugins/tags/toc/) * [Advanced View](https://haz.wordpress.org/plugins/heroic-table-of-contents/advanced/) ## Ratings 4.7 out of 5 stars. * [ 7 5-star reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/?filter=5) * [ 3 4-star reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/heroic-table-of-contents/reviews/) ## Contributors * [ HeroThemes ](https://profiles.wordpress.org/herothemes/) * [ Richard Long ](https://profiles.wordpress.org/richardlong/) * [ Chris Hadley ](https://profiles.wordpress.org/chrishadley/) ## Support Issues resolved in last two months: 1 out of 1 [View support forum](https://wordpress.org/support/plugin/heroic-table-of-contents/)