How It Works

The Table of Contents (TOC) feature automatically generates a navigation box from the headings in your post or page content. Visitors can jump to any section with a single click.

How the TOC is generated

1. The theme scans post content for <h2> and optionally <h3> tags.
2. For each heading found, it strips any leading number patterns (e.g., "1. ", "2.1 ") from the label used in the TOC links — the original heading text in the article is not modified.
3. It injects an id attribute onto each heading in the article (using a URL-safe version of the heading text as the anchor).
4. It renders the TOC box with clickable links pointing to those anchors.

Insertion position

The TOC box is inserted into the content automatically — no shortcode needed. The position can be configured:

• Before the first heading (default) — the TOC appears just before the first H1–H6 tag in the article.
• Before content — the TOC is prepended to the entire content, before any HTML.
• After content — the TOC is appended at the very end of the article.

Heading levels

By default, both H2 and H3 headings are included. Enable Exclude H3 in the Customizer to include only H2 headings. This keeps the TOC shorter for long articles.

Numbering

If a heading starts with a numbering pattern like 1 - Section Name or 2.3 Topic, the number prefix is stripped from the TOC link text only — the heading in the article keeps its original text. This lets you use numbered headings for visual structure without making the TOC links verbose.

When the TOC does not appear

The TOC will not render if:

• No H2 or H3 tags are found in the post content.
• The current page is not a single post or page (the TOC never appears on archive pages or the homepage).
• The TOC is disabled for the current post type (posts or pages can be enabled independently).
• Your license is not active.