Supplyist TOC Block

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

1. Upload the plugin files to /wp-content/plugins/supplyist-toc-block/, or install directly from the WordPress plugin directory.
2. Activate the plugin through the Plugins menu in WordPress.
3. Add the “Custom Table of Contents” block anywhere in your editor.

1. 

   Screenshot of the block in editor.

2. 

   Example of a generated "Table of Contents".

1.0.0

• Initial release.