The best Table of Contents plugin for WordPress. Auto or manual insert, Gutenberg Block, beautiful themes, onboarding wizard, and deep customization.

WPJoli

Joli Table Of Contents is the most customizable and performance-focused table of contents plugin for WordPress. It works out of the box for beginners — thanks to a built-in Onboarding Wizard — and offers deep control for advanced users and developers.
Easily insert a table of contents into all your posts with either the Auto-insert, the Gutenberg Block, or the Shortcode.
<a href="https://wpjoli.com/docs/joli-table-of-contents/" title="Joli Table Of Contents Documentation" rel="nofollow ugc">📖 Documentation</a> | <a href="https://wpjoli.com/joli-table-of-contents/" title="Joli Table Of Contents Pro" rel="nofollow ugc">⭐ Get PRO</a>
<h3>🚀 Why Joli Table Of Contents?</h3>
<h3>✅ Beginner-Friendly Onboarding Wizard</h3>
After activation, a step-by-step setup wizard walks you through the most important settings — no configuration headaches, no reading documentation. You’ll have a working, good-looking TOC in minutes.
<h3>🎨 Instant Customization with the Color Palette System</h3>
The new Color Palette makes customization effortless. Set just the Accent color and it automatically propagates across your entire TOC — that’s 90% of the visual work done in a single click. Fine-tune everything else at your own pace.
<h3>🧠 Smart Heading Detection</h3>
Joli Table Of Contents accurately detects headings from third-party shortcodes and blocks that don’t appear directly in the editor but are rendered on the front end. Since v3, you can now choose between Content scope (default — prevents unwanted headings from appearing) and Extended scope for advanced use cases.
<h3>🆕 Gutenberg Block with Inline Editing</h3>
Use the dedicated Gutenberg Block to insert a table of contents anywhere in your post. The block lets you hide or edit specific headings inline — no settings page needed.
<h3>⚡ Performance First</h3>
No jQuery dependency. Minified CSS and JavaScript. Conditional style loading based on active settings — only the code you need is loaded. Built for fast websites.
<h3>🔁 Migrate from Another TOC Plugin — Without Touching Your Content</h3>
Already using Easy Table of Contents, LuckyWP Table of Contents, or another plugin? You can switch to Joli TOC without updating a single shortcode across your posts.
Use the built-in filter to map Joli TOC to your existing shortcode tag:
<pre><code>add_filter('jolitoc_shortcode_tag', function(){ return 'toc'; });
</code></pre>
This works with any custom tag, so your existing <code>[toc]</code> (or any other) shortcodes continue to work immediately after switching.
<h3>✨ Key Features</h3>
Design & Themes: 
* Professional looking themes (Default, Original, Hero, + all legacy themes) 
* Dark mode support for v3 themes 
* Color Palette system — set one color, style the whole TOC 
* Fully customizable: padding, margin, borders, fonts, colors, icons 
* Custom CSS support 
* CSS variable architecture for deep theming 
* Custom theme engine (create your own theme)
Insertion methods: 
* Auto-insert (by post type and position) 
* Gutenberg Block 
* Shortcode <code>[joli-toc]</code>
Auto-insert positions: 
* Before/After the content 
* Before/After H1 
* Before first H2 / After first H2 
* After first paragraph
Headings & Detection: 
* Detect headings from third-party blocks and shortcodes 
* Heading scope: Content (default) or Extended 
* Show headings by custom depth (H2 to H6) 
* Hide or edit specific headings via the block 
* Disable headings by text or CSS class
Navigation & UX: 
* Reading time estimate (new in v3) 
* Hierarchical or Flat view 
* Multiple numbering styles (with regional number support) 
* Customizable numbering separator and suffix 
* Smooth scrolling 
* Folding/unfolding with animation 
* Pretty URL hash (e.g. <code>mysite.com/article/#section-title</code>) 
* Latin & non-latin character support 
* Multilingual hash transliteration 
* Responsive — hover events work as touch on mobile
Other: 
* Import / Export settings 
* Import presets for quick setup 
* Custom CSS section 
* Fully responsive 
* <code></code> multi-page support 
* RTL support 
* WPML compatible 
* No jQuery 
* Developer hooks (<a href="https://wpjoli.com/docs/joli-table-of-contents/developer-hooks/" rel="nofollow ugc">see full list</a>)
<h3>⭐ What’s New in v3</h3>
<h3>🧙 Onboarding Wizard</h3>
New users are greeted with a step-by-step onboarding wizard that configures the most important settings for their site — without needing to touch advanced options.
<h3>🎨 Color Palette System</h3>
A brand-new reusable color palette makes customization fast and consistent. Define your Accent color once and watch it style your entire TOC automatically.
<h3>🖼 New & Updated Themes</h3>
v3 ships with new and upgraded themes: Default (replaces Basic Light/Dark), Original, and Hero — all with dark mode support and theme-specific style variants.
<h3>🎛 Redesigned Settings Page</h3>
The admin interface has been fully redesigned with: 
* A search bar to quickly find any setting 
* A Live Preview panel — see your changes in real time 
* A Quick Settings Panel for the most common options 
* Better color pickers with palette support 
* Session checker to prevent lost changes
<h3>📐 New Style Options</h3>
New styling controls include: header border style/width/radius/color, numbering badge colors, base font size, and toggle button styles.
<h3>🔢 Improved Numbering System</h3>
The numbering engine has been upgraded to behave like a proper list — including support for regional numbering formats. Hexadecimal and binary modes have been removed.
<h3>📍 TOC Alignment</h3>
Choose between left, center, and right alignment for the entire TOC block.
<h3>📖 Reading Time Estimate</h3>
Automatically display an estimated reading time inside the TOC header.
<h3>🔒 PRO Features</h3>
<a href="https://wpjoli.com/joli-table-of-contents/" rel="nofollow ugc">Get Joli Table Of Contents Pro →</a>
Premium Themes:
Widgets: 
* 🆕 Timeline TOC — display the TOC as a visual timeline on the side of the screen, with proportionally spaced markers 
* ✅ Floating TOC Widget — follows the user as they scroll, shows the active section 
* ✅ Slide-Out TOC Widget — fixed panel on the side of the screen 
* ✅ Sticky Sidebar TOC — TOC in a sidebar widget that sticks while scrolling 
* ✅ Progress Bar Widget — reading progress indicator at the top of the page
PRO-only customization: 
* ⭐ Collapsible headings 
* ⭐ View more button (Partial fold) 
* ⭐ Independent top-level heading styling 
* Separator between top-level headings 
* Multi-columns mode 
* Per-device TOC visibility (in-content vs. sidebar) 
* Fade past headings
Advanced auto-insert rules: 
* Filter by post type, post title, or post ID 
* Exclude specific posts by title or ID 
* Different settings per post type (theme, layout, everything)
Custom Post Type support with per-post-type settings.
<h3>🔧 Shortcode</h3>
Insert the TOC anywhere using the shortcode:
<pre><code>[joli-toc]
</code></pre>
Migrating from another plugin? Keep your existing shortcode tag without updating any content:
<pre><code>add_filter('jolitoc_shortcode_tag', function(){ return 'toc'; });
</code></pre>
This is compatible with shortcode tags used by Easy Table of Contents, LuckyWP Table of Contents, and others.
<h3>🎣 Developer Hooks</h3>
Joli Table Of Contents provides a full set of action and filter hooks for developers.
<a href="https://wpjoli.com/docs/joli-table-of-contents/developer-hooks/" rel="nofollow ugc">View all available hooks →</a>
Common examples (add to your theme’s <code>functions.php</code>):
Disable auto-insert globally: 
 add_filter(‘joli_toc_disable_autoinsert’, function(){ return true; });
Disable JS or CSS: 
 add_filter(‘joli_toc_disable_js’, function(){ return true; }); 
 add_filter(‘joli_toc_disable_styles’, function(){ return true; });
Customize the TOC title dynamically: 
 add_filter(‘joli_toc_toc_title’, function( $title ){ return ‘My Custom Title’; });
<h3>🔌 More Plugins by WPJoli</h3>
<ul>
<li><a href="https://wordpress.org/plugins/smart-auto-featured-image/" rel="ugc">Smart Auto Featured Image</a></li>
<li><a href="https://wordpress.org/plugins/zenform/" rel="ugc">ZenForm</a></li>
<li><a href="https://wordpress.org/plugins/joli-faq-seo/" rel="ugc">Joli FAQ SEO</a></li>
<li><a href="https://wordpress.org/plugins/joli-clear-lightbox/" rel="ugc">Joli CLEAR Lightbox</a></li>
</ul>

Alternatives to Joli Table Of Contents

Top alternatives