Table of Contents (TOC) Block – Fast & SEO Friendly
Changelog
1.3.0 – 21/06/2026
New: Heading count badge – optionally display the number of visible headings next to the TOC title.
New: Exclude headings by keyword – type comma-separated keywords in the block sidebar; any heading whose text contains a match is hidden from the TOC and skipped by per-section back-to-top links.
Fix: The “minimum headings to show TOC” threshold now correctly counts only the headings that will actually appear in the TOC, so keyword-excluded headings no longer count toward the minimum.
Fix: The “Back to top” link inside the TOC now scrolls back to the top of the page correctly even when JavaScript is disabled.
Fix: TOC list HTML is now always well-formed when the last heading in a post is hidden from the TOC (via CSS class or keyword exclusion).
Improvement: The block sidebar now shows an informational notice when the heading count badge is enabled but the TOC title is hidden, since the badge has nowhere to appear in that configuration.
1.2.0 – 14/06/2026
New: Native color picker – set the TOC background and text color directly from the block sidebar without needing to wrap it in a Group block.
New: Per-section “Back to top” links – optionally insert a return-to-top link after every heading in the post content.
New: Minimum headings threshold – optionally hide the TOC automatically if the post has fewer qualifying headings than a number you choose.
New: Exclude headings from the TOC by adding the CSS class wpwing-toc-hidden to any heading block via its Advanced settings panel.
New: Yoast SEO integration – the block is now recognized as a TOC by Yoast SEO in addition to the existing Rank Math support.
Fix: Headings with multiple CSS classes (e.g. a font size applied alongside wpwing-toc-hidden) are now correctly excluded from the TOC.
Fix: Hidden headings no longer receive a per-section “Back to top” link in the post content.
Fix: The TOC no longer renders an empty <nav> element when all headings fall outside the selected minimum/maximum level range.
Fix: Back to top links now respect the “Enable smooth scrolling” setting instead of always scrolling smoothly.
Fix: Heading anchor IDs are now found and applied correctly inside nested block structures such as Groups and Columns, and page numbers are now assigned accurately to headings inside those nested structures too.
Improvement: Collapsible toggle button now shows a visible focus ring for keyboard users.
Improvement: “Back to top” link styling is now applied consistently to both the TOC link and per-section links in the post content.
1.1.0 – 07/06/2026
New: Collapsible TOC – add a toggle button so readers can show or hide the table of contents with one click.
New: Boxed style preset – wrap the TOC in a subtle bordered box with a single click from the sidebar.
New: “Back to top” link – optionally show a link below the TOC that scrolls readers back to the top of the page.
Improvement: Sidebar settings are now grouped into three clear sections – Content, Display, and Links & Behavior – making them much easier to navigate.
Improvement: Renamed confusing labels. “Remove heading” is now “Hide TOC Title”, “Remove list indent” is now “Flat list (no indent)”, and “Smooth scrolling support” is now “Enable smooth scrolling”.
Improvement: Added a warning when the minimum heading level is set deeper than the maximum, so you know immediately if the TOC will be empty.
Improvement: All sidebar controls now have clear, plain-language descriptions explaining exactly what each option does.
Improvement: Added safe default list spacing so the TOC looks consistent across all themes without overriding your theme’s styling.
1.0.9 – 30/05/2026
New: Custom Title — set your own TOC heading text directly from the block sidebar.
