Supplyist TOC Block

A simple Gutenberg block that automatically generates a nested table of contents from post headings.

By suppress

Version 1.0.0 Active Installs 0+ Updated 5 days ago 5 days old

Description

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

Plugin comparisons

See how this plugin stacks up against alternatives side by side.