Make your next article easy to read.
Give every section a clear place in the story.
Get started
Your contents follow the heading structure you already use. The document stays yours.
A table of contents for WordPressLong articles.
Long articles.
Easy to explore.
Give readers a clear path through your content. Start with a complete Free plugin. Add Pro when your publishing workflow needs more.
Works on your siteNo account requiredFree stays free
Settings
Make it yours.
Automatically insert
Heading levelsH2 H3
AppearanceSoft card
Your theme. Your content. Your settings.
Fieldnotes / Guides
A better reading experience
For readersFind the right section.
Clear headings, working links, and a visible reading position.
For authorsKeep control of your content.
Change TOC labels without rewriting article headings or existing IDs.
For your siteEverything runs locally.
No account, tracking service, external scripts, or front-end credit link.
Explore the pluginA little structure.
A little structure.
A much clearer article.
Start with friendly defaults. Fine-tune the appearance. Open the interactive design preview to explore Free and Pro side by side.
Free is a complete plugin.
Open full plugin previewAutomatic placement, five presets, spacing and colors, a manual block, and per-post controls.
Design preview with sample content. It does not change a WordPress site.
Free & ProChoose the workflow
Choose the workflow
that fits your site.
Free is enough for many blogs. Pro adds shared publishing controls for bigger content libraries. Both use the same core table of contents.
Free
A strong everyday TOC.
For blogs, article pages, and straightforward publishing.
- Automatic insertion and a manual block or shortcode
- Five presets, colors, width, spacing, and typography
- Per-post controls, custom TOC labels, and exclusions
- Collapse controls and current-section highlighting
$0 — no time limitDownload Free beta
Pro add-on
Consistency at scale.
For publishers and teams with different types of articles.
- Everything in the Free plugin
- Ordered rules with All / Any conditions
- Shared templates and content-type assignments
- Adaptive desktop rail and searchable mobile contents
Pro beta — pricing not announcedDownload Pro beta
| Feature | Free | Pro add-on |
|---|---|---|
| Automatic placement and heading-level selection | Included | Included through Free |
| Manual block and [tocgenius] shortcode | Included | Included through Free |
| Appearance presets, width, alignment, and spacing | Included | Included through Free |
| Theme inheritance and custom colors | Included | Included through Free |
| Per-post placement, labels, and heading exclusions | Included | Included through Free |
| Collapse, numbering, and current-section highlight | Included | Included through Free |
| Basic sticky contents and header offset | Included | Included through Free |
| Post diagnostics explaining TOC visibility | Included | Includes rule evaluation |
| Ordered publishing rules | Pro information tab | Up to 30 rules |
| All / Any conditions | — | Up to 8 per rule |
| Shared appearance templates | — | Up to 30 templates |
| Assign templates to rules and content types | — | Included |
| Validated template JSON import / export and undo | — | Included |
| Adaptive desktop side rail | — | When the theme has room |
| Mobile contents panel with section search | — | Included |
| Automatic migration from another TOC plugin | Not in this release | Not in this release |
Pro installs alongside Free. Free’s PRO tabs describe the separate add-on; there is no locked premium implementation in the Free package.
Publishing with ProThe right design.
The right design.
For the right article.
Create a shared appearance once. Assign it to a content type or a rule. Update it later and every assignment follows.
Rule priority
First match wins1
Long guides
AppliedCategory: guides AND eligible headings ≥ 4
Technical template2
Short news articles
Category: news
Editorial template01
Choose the conditions.
Match categories, tags, content types, title text, or heading counts. Use All or Any to make the logic clear.
02
Set the priority.
The first enabled matching rule wins. Diagnostics explain what matched and which rule took priority.
03
Reuse the appearance.
Assign a shared template. Change it once, then reuse the library through JSON export and import.
Get started
Install. Choose. Publish.
No registration flow. No setup wizard to get through. Start with Posts, H2–H3 headings, and a minimum of three headings.
- 01
Install Free.
In WordPress, open Plugins → Add New → Upload Plugin. Upload the Free ZIP and activate it.
- 02
Choose your defaults.
Open Settings → TOC Genius. Set placement, heading levels, appearance, and reader behavior.
- 03
Check an article.
Edit a post to change TOC labels or exclusions. Use Tools to understand why the TOC appears.
Adding Pro? Install its ZIP after Free, then open Rules, Saved templates, or Advanced navigation. Pro starts with no rules or templates and inherits the global layout.
Read the installation and usage guideClear answersKnow what
Know what
you’re installing.
Will Free stay usable without upgrading?
Yes. Free has no time limit, account requirement, or local premium code waiting to be unlocked. The PRO tabs explain features in a separate add-on.
Does it change my article headings or existing links?
TOC labels can be changed independently. Existing HTML heading IDs are preserved. For headings without IDs, the plugin adds collision-safe IDs to the rendered output; it does not rewrite the stored article. If an existing ID is duplicated, that heading is excluded and a diagnostic explains why.
Can I place a TOC manually?
Yes. Add the TOC Genius block or [tocgenius] inside the article body. A manual TOC replaces automatic insertion for that article. If several markers exist, only the first is used.
What happens when Pro is deactivated?
Free continues using its global settings and per-post controls. Pro rules, templates, and adaptive navigation stop applying. Saved data is retained.
Does it send data to TOC Genius?
No. These plugin packages have no telemetry, licensing requests, external assets, or front-end credit links. Pro is a separate local add-on. WordPress itself still performs its normal platform operations.
Can it migrate an existing TOC plugin?
Automated migration is not included in version 0.1.1. Existing HTML IDs are preserved, but IDs generated only by another plugin may need to be saved into your content. Test old links on staging before switching.
Is it approved on WordPress.org?
Not yet. These are beta packages for staging evaluation. The Free package follows the separate-add-on approach recommended by WordPress.org. Directory acceptance requires submission and review by the WordPress Plugins Team.
Is there a checkout or a Pro subscription?
Not in this first release. The Pro beta can be evaluated without a license server. Commercial pricing, support terms, payment processing, and an update service have not been launched.
Version 0.1.1Your next article,
Maintenance beta · Not yet on WordPress.orgYour next article,
with a clearer path.
Installable beta packages. Start on a staging site and review a few real articles before using them across your site.
TOC Genius
Everything you need for a customizable automatic table of contents.
Download Free ZIPTOC Genius Pro
Publishing rules, shared templates, and adaptive article navigation.
Download Pro ZIPRequires Free 0.1.1 or later. Update Free first.Source & release notes
Both plugin sources, test results, scope, and repository preparation guidance.
Download source bundleRead release notesSupported scope
WordPress 6.5+ and PHP 7.4+. Article-body headings on singular posts and pages, with opt-in support for other public content types. Dynamic page builders and every theme combination have not been certified. Automatic migration, checkout, license management, and a Pro update service are outside this release.