Table of Contents

Auto-generate a table of contents from post headings with anchor links for easier navigation. Perfect for long-form articles, tutorials, and documentation.

Use Cases

  • Add clickable TOC to 3000+ word tutorials for easy navigation
  • Create anchor-linked TOC on documentation pages
  • Generate structured TOC for better Google search results with jump links

How It Works

  1. Scans content for headings matching your configured levels
  2. Generates unique anchor IDs for each heading
  3. Builds a hierarchical list with clickable links
  4. Inserts TOC at your chosen position
  5. Adds smooth scroll behavior

Settings

SettingTypeDefaultDescription
Auto InsertToggleEnabledAutomatically add TOC to posts
PositionSelectAfter First ParagraphWhere to display the TOC
Minimum HeadingsNumber3Only show if post has this many headings
Heading LevelsText2,3Comma-separated levels (e.g., “2,3,4” for H2-H4)
TOC TitleTextTable of ContentsTitle above the TOC
Numbered ListToggleDisabledUse numbers instead of bullets

Shortcode

Use [toc] to manually place the table of contents:

[toc]

Place [toc] after your introduction paragraph. Readers get context first, then can navigate.

Styling

The TOC is wrapped in a div with class switchboard-toc. Customize with CSS:

.switchboard-toc {
    background: #f5f5f5;
    padding: 20px;
    border-radius: 8px;
    margin: 20px 0;
}

.switchboard-toc h3 {
    margin-top: 0;
}

.switchboard-toc a {
    color: #0073aa;
    text-decoration: none;
}

.switchboard-toc a:hover {
    text-decoration: underline;
}

FAQ

Why isn’t my TOC showing?Check that your post has at least the minimum number of headings configured (default: 3). Also verify you’re using the correct heading levels (default: H2 and H3).
Does it work with Gutenberg?Yes! The module scans rendered HTML content, so it works with both classic editor and Gutenberg heading blocks.
Will it affect my SEO?Positively! Google can use TOC links to show jump-to-section links in search results, improving CTR and user experience.
Can I exclude certain headings?Currently, all headings matching your configured levels are included. Adjust which levels to include in settings.
PRO

Get access to all 147 modules with a single license

Upgrade to Pro