Configuration
All TOC settings are at Appearance → Customize → Table of Contents. An active license is required for this section to appear.
Settings reference
| Setting | Default | Description |
|---|---|---|
| Enable on posts | Off | Automatically generate a TOC on single posts. |
| Enable on pages | Off | Automatically generate a TOC on static pages. |
| Allow user to change visibility | Off | Adds a chevron button to the TOC header that lets visitors collapse/expand it. |
| Hide initially | Off | When the visibility toggle is enabled, start the TOC in a collapsed state. (Only available when "Allow user to change visibility" is on.) |
| Enable smooth scrolling | Off | Adds scroll-behavior: smooth to the page so clicking TOC links scrolls smoothly instead of jumping. |
| Exclude H3 | Off | Include only H2 headings; H3 headings are not listed in the TOC. |
| TOC layout | Normal | Visual style of the TOC box (see below). |
| Position | Before the first heading | Where the TOC box is inserted in the content (see the How It Works article). |
| List type | Numbered list | Display TOC entries as a numbered list (<ol>), a bulleted list (<ul>), or without numbers/bullets. |
| Title | Table of Contents | The heading text shown at the top of the TOC box. |
TOC layout options
- Normal — a plain box with a light background, using the site's body font and standard border.
- Like Header — the TOC title bar uses the header background and text colors for a branded look.
- Like Buttons — the TOC title bar uses the button background and text colors.
- Modern — a minimal flat style with a colored left border accent.
Smooth scrolling note
The smooth scrolling option adds a global html { scroll-behavior: smooth; } rule. This affects all anchor links on the page, not just TOC links. If another element on your page uses anchor navigation and you do not want smooth scrolling there, you may need to add scroll-behavior: auto to that specific element in your child theme's CSS.
Dark mode compatibility
The TOC box automatically adapts to dark mode when dark mode is enabled — no extra configuration needed. The dark-mode.css file includes TOC-specific overrides for backgrounds, borders, and link colors.