Add the
Table of Contents Block anywhere in your Gutenberg editor. It scans H2–H6 headings in the post content and builds a nested, clickable table of contents. Links automatically work by adding IDs to headings.
No configuration needed. Works on single posts and pages (not archives or category listings).
- No theme editing required
You can activate the plugin on any site.
- Compatible with Gutenberg / Classic Editor
It processes the final rendered HTML.
- SEO-friendly
IDs are based on sanitize_title(), the same function WP uses for slugs.
- Works with headings that already have IDs
It does not overwrite existing IDs.
Example:
- Structure Your Content - Write your post or page using semantic headings (H2, H3, etc.)—just like you normally would.
- Insert the Table of Contents Block - Add the "Table of Contents Block" anywhere in your editor (e.g., right after the introduction).
- Let It Work Automatically - The plugin scans your headings, builds a hierarchical, scroll-linked table of contents in real time, and updates dynamically as you edit.
Key Features
- Server-side generated Table of Contents
- Automatically detects H2–H6 headings
- Generates nested lists based on heading hierarchy
- Automatically adds IDs to headings when missing
- Lightweight and simple
- Useful for:
- Adding a Table of Contents to a post or page
- Generating heading IDs
- Linking to sections within content
Why use this plugin?
- Smart Parsing: Supports H2 through H6 headings
- Clean Output: Uses standard HTML lists for maximum theme compatibility
- Non-intrusive: Does not modify existing heading IDs
- Lightweight & Fast