Mocursor Smart TOC

Mocursor Smart TOC is a lightweight, feature-packed Gutenberg block that automatically generates a linked table of contents from the headings in your posts and pages. Simply drop it into your content — it just works. Also available as a [mctoc] shortcode for classic editor users.

The block is fully dynamic, accessible, lightweight, and theme-aware. It uses WordPress design tokens and CSS custom properties so it inherits your theme’s colors, fonts, and spacing automatically.

Shortcode Support

The Mocursor Smart TOC block is also available as a [mctoc] shortcode for use in the classic editor, widgets, or theme templates.

Basic usage:

[mctoc]

With options:

[mctoc title="On This Page" include_h2="true" include_h3="true" include_h4="false" numbering="nested" collapsed="true" sticky="true" offset="100" skip="1" exclude_headings="Related Posts,Comments" back_to_top="true" align="right" justify=""]

Available shortcode attributes:

• title — TOC heading text (default: “Table of Contents”)
• include_h2 — Include H2 headings: “true” or “false” (default: “true”)
• include_h3 — Include H3 headings: “true” or “false” (default: “true”)
• include_h4 — Include H4 headings: “true” or “false” (default: “true”)
• exclude_headings — Comma-separated heading texts to exclude
• numbering — Numbering style: “none”, “decimal”, or “nested” (default: “none”)
• collapsed — Start collapsed: “true” or “false” (default: “false”)
• sticky — Enable sticky mode: “true” or “false” (default: “false”)
• offset — Scroll offset in pixels for fixed headers (default: 80)
• skip — Number of headings to skip from the start (default: 0)
• back_to_top — Show “Back to Top” link: “true” or “false” (default: “false”)
• align — Floating block alignment: “left”, “center”, or “right”. Left/right allow nearby content to wrap beside the TOC.
• justify — No-wrap TOC position: “left”, “center”, or “right”. Surrounding content stays above and below the TOC.

Ideal Use Cases

Mocursor Smart TOC is perfect for:

• Long-form blog posts — Help readers navigate 2,000+ word articles with ease.
• Documentation and knowledge bases — Technical docs, how-to guides, and reference pages.
• Online courses and tutorials — Give learners a clear roadmap of every lesson section.
• Legal, policy, and compliance pages — Terms of service, privacy policies, and similar documents.
• Product and feature pages — Long product descriptions with multiple sections.
• Recipe and travel blogs — Readers can jump to the section they care about.
• Wiki-style internal sites — Any WordPress site used as an internal wiki or resource library.
• Accessibility-focused sites — The TOC gives keyboard and screen reader users a reliable way to navigate.
• Classic editor users — The shortcode works perfectly in the classic editor.

Why Choose Mocursor Smart TOC?

1. Zero configuration needed — Drop the block in and it works immediately.
2. 100% Gutenberg-native + Shortcode — Built as a real Gutenberg block with a classic shortcode fallback.
3. Dynamic and always up to date — Server-rendered, always matches the current content.
4. Incredibly lightweight — No JavaScript frameworks. Pure vanilla JS for all interactivity.
5. Deeply customizable — Rich inspector controls for heading levels, numbering, collapsibility, sticky mode, and more.
6. Accessible by default — Proper ARIA attributes, keyboard navigation, semantic HTML, and focus management.
7. Theme-aware — Uses WordPress design tokens and CSS custom properties.
8. No lock-in — Deactivate the plugin and your content is untouched.
9. Privacy-friendly — No external requests, no tracking, no analytics, no cookies.
10. Open source — Licensed under GPLv2.

Block Features

Read the full description on the official page →