Title: AriTOC – Table of Contents by AriHub
Author: AriHub
Published: <strong>November 19, 2026</strong>
Last modified: November 19, 2026

---

Search plugins

![](https://ps.w.org/aritoc/assets/banner-772x250.png?rev=3812507)

![](https://ps.w.org/aritoc/assets/icon.svg?rev=3812507)

# AriTOC – Table of Contents by AriHub

 By [AriHub](https://profiles.wordpress.org/arihub/)

[Download](https://downloads.wordpress.org/plugin/aritoc.2.1.0.zip)

 * [Details](https://wordpress.org/plugins/aritoc/#description)
 * [Reviews](https://wordpress.org/plugins/aritoc/#reviews)
 *  [Installation](https://wordpress.org/plugins/aritoc/#installation)
 * [Development](https://wordpress.org/plugins/aritoc/#developers)

 [Support](https://wordpress.org/support/plugin/aritoc/)

## Description

AriTOC reads the headings of your posts and pages and builds a table of contents
your readers will actually use. Each heading gets a clean anchor, the section being
read is highlighted, and nothing is loaded on pages that do not show a table.

#### Place it the way you like

 * **Automatically** on posts, pages and any public custom post type: before or 
   after the first heading, after the first paragraph, at the top or at the bottom.
 * **Block**: the “Table of Contents (AriTOC)” block shows a live preview of your
   headings in the editor. In block themes you can put it in a template or a sidebar
   from the Site Editor.
 * **Shortcode** `[aritoc]` with options for title, levels, exclusions, numbering,
   theme and more.
 * **Widget** for classic theme sidebars.
 * **Template tag** `aritoc()` for theme developers.

#### Made for real content

 * **Paginated posts**: posts split with the Page Break block (`<!--nextpage-->`)
   get one table with the headings of every page, linking across pages.
 * **Block themes and classic themes**: works with Twenty Twenty-Five and other 
   block themes as well as classic themes.
 * **Any language**: readable anchors keep letters and accents of every script, 
   so Bengali, Arabic, Norwegian or Japanese headings get meaningful links. Or choose
   Latin-only or numbered anchors.
 * Existing HTML anchors are kept. Generated anchors never clash with other ids 
   in the content or with ids themes commonly use (#comments, #content, #main and
   similar).
 * Skip headings by text (with * wildcards), by CSS class, or give one heading the
   class `no-toc`.
 * Show a shorter label in the table with `data-aritoc-label` on the heading.
 * Headings inside code, scripts and forms are ignored.

#### Looks good everywhere

 * Light, dark, automatic (follows the visitor’s device), AriHub gradient, minimal,
   inherit-your-theme and custom colors.
 * Nested numbers (1, 1.1), numbers per level, roman numerals, letters, bullets 
   or none.
 * Fit to content, full or medium width; centered or floating left or right with
   text wrapping around.
 * Two columns for long tables on wide screens.
 * Live preview on the settings screen as you change options.
 * Right-to-left languages supported.

#### Tells you why

The settings screen can check any page: it says whether a table appears, why or 
why not, and lists every heading with its anchor or the reason it was skipped (level
not selected, a skip class, a matching skip rule, no text). No more guessing why
a table is missing.

#### Fast and accessible

 * One small stylesheet and one small deferred script, only on pages that show a
   table. No jQuery.
 * Collapsing uses the browser’s own details element: it works without JavaScript,
   with the keyboard and with screen readers.
 * Labelled navigation landmark, `aria-current` on the section being read, and focus
   moves to the heading after a click.
 * Smooth scrolling that respects the reduced-motion setting, and a scroll offset
   for sticky headers.
 * Optional: keep the address bar clean (no #section added on click).
 * Optional “#” link next to each heading so readers can copy a link to that section.
 * Print friendly: collapsed tables are printed in full.

#### Switch from another plugin in one click

Moving from Easy Table of Contents, Table of Contents Plus or LuckyWP Table of Contents?
Settings > AriTOC > Tools copies their settings and keeps their shortcodes (`[toc]`,`[
ez-toc]`, `[lwptoc]`, `[no_toc]`) working with AriTOC, so you do not have to edit
any post. Easy Table of Contents’ “disable on this post” choices are respected too.

#### Works with

 * Rank Math: the “Use a table of contents” check passes with AriTOC.
 * Any editor or page builder that prints content through the standard `the_content`
   filter. Elsewhere, use the shortcode or block.

#### Per-page control

The editor sidebar lets you always show or hide the table on one page, and change
its title, heading levels and exclusions for that page.

#### AriTOC Pro

AriTOC Pro is a separate add-on from [arihub.com](https://www.arihub.com/aritoc/).
It adds a floating table that follows the reader, a reading progress bar, reading
time, “Show more” for long tables, folding sub-headings, extra design controls and
priority support. The free plugin stays fully functional without it.

### Developers

Filters: `aritoc_reserved_ids`, `aritoc_settings`, `aritoc_settings_schema`, `aritoc_sanitize_settings`,`
aritoc_auto_insert`, `aritoc_add_anchors`, `aritoc_enqueue`, `aritoc_heading`, `
aritoc_anchor`, `aritoc_items`, `aritoc_classes`, `aritoc_attributes`, `aritoc_title_after`,`
aritoc_html`, `aritoc_page_html`, `aritoc_post_mode`.

Functions: `aritoc( $args )`, `aritoc_get( $args, $post )`, `aritoc_get_headings(
$post )`.

JavaScript: `window.AriTOC.init( element )`, and the `aritoc:active` and `aritoc:
jump` events.

CSS custom properties on `.aritoc`: `--aritoc-bg`, `--aritoc-fg`, `--aritoc-mut`,`--
aritoc-line`, `--aritoc-link`, `--aritoc-act`, `--aritoc-rad`, `--aritoc-gap`.

## Screenshots

[⌊The table inserted automatically before the first heading, with the section being
read highlighted.⌉⌊The table inserted automatically before the first heading, with
the section being read highlighted.⌉[

The table inserted automatically before the first heading, with the section being
read highlighted.

[⌊Built-in looks: light, dark, AriHub gradient, minimal and custom colors, with 
six numbering styles.⌉⌊Built-in looks: light, dark, AriHub gradient, minimal and
custom colors, with six numbering styles.⌉[

Built-in looks: light, dark, AriHub gradient, minimal and custom colors, with six
numbering styles.

[⌊Settings grouped by task, with a live preview that can use one of your own pages.⌉⌊
Settings grouped by task, with a live preview that can use one of your own pages
.⌉[

Settings grouped by task, with a live preview that can use one of your own pages.

[⌊Tools: copy settings from another table of contents plugin, keep its shortcodes
working, export, import or reset settings.⌉⌊Tools: copy settings from another table
of contents plugin, keep its shortcodes working, export, import or reset settings
.⌉[

Tools: copy settings from another table of contents plugin, keep its shortcodes 
working, export, import or reset settings.

[⌊On a phone: the table fits the screen and collapses with a tap.⌉⌊On a phone: the
table fits the screen and collapses with a tap.⌉[

On a phone: the table fits the screen and collapses with a tap.

[⌊Check a page: see whether a page gets a table, and why each heading is listed 
or skipped.⌉⌊Check a page: see whether a page gets a table, and why each heading
is listed or skipped.⌉[

Check a page: see whether a page gets a table, and why each heading is listed or
skipped.

## Blocks

This plugin provides 1 block.

 *   Table of Contents (AriTOC) Lists the headings of the post with links to each
   section. Place it in a post, or in a theme template or sidebar.

## Installation

 1. Install AriTOC from Plugins > Add New, or upload the `aritoc` folder to `/wp-content/
    plugins/`.
 2. Activate it.
 3. Go to Settings > AriTOC to choose where and how the table appears.

## FAQ

### Why does a page show no table?

Go to Settings > AriTOC > Overview and use “Check a page”: it tells you why, and
shows what happens to every heading. In short: it needs at least the minimum number
of headings (3 by default) at the selected levels, the post type must be selected
under “Insert automatically on” (or use the block or shortcode), and the page must
not be set to “Hide” in the editor sidebar.

### How do I skip one heading?

Select the heading in the block editor, open Advanced and add the CSS class `no-
toc`.

### My sticky header covers the heading after clicking

Set “Scroll offset” in Settings > AriTOC > Behavior to the height of your header.

### Can I use the shortcode options?

Yes: `[aritoc title="In this article" levels="2,3" exclude="FAQ|Related*" numbering
="roman" theme="dark" collapsible="yes" collapsed="no" hierarchical="yes" class="
my-toc"]`. Anything you leave out uses the settings page.

### Does it work with my page builder?

When the builder prints content through `the_content`, the automatic table works.
Otherwise add the `[aritoc]` shortcode where you want the table.

### What happens to my data if I delete the plugin?

Settings are kept unless you tick “Delete all AriTOC settings” in Settings > AriTOC
> Tools.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“AriTOC – Table of Contents by AriHub” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ AriHub ](https://profiles.wordpress.org/arihub/)

[Translate “AriTOC – Table of Contents by AriHub” into your language.](https://translate.wordpress.org/projects/wp-plugins/aritoc)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/aritoc/), check out
the [SVN repository](https://plugins.svn.wordpress.org/aritoc/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/aritoc/) by [RSS](https://plugins.trac.wordpress.org/log/aritoc/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.1.0

 * New: Overview tab with a plain-language summary of how AriTOC works on your site.
 * New: “Check a page” shows whether a page gets a table, why, and what happens 
   to every heading (listed, or skipped and why). It uses unsaved changes too.
 * New: preview the table with one of your own pages, not only sample headings.
 * New: save bar that shows unsaved changes and warns before you leave, and “Reset
   to defaults” in Tools.
 * New: low-contrast warning for custom colors.
 * Changed: settings are grouped into Placement, Headings, Appearance and Navigation;“
   Start collapsed” is only available when collapsing is on.
 * Changed: the editor box option “Always show” is now “Show on this page (when 
   it has enough headings)”, which is what it always did.
 * Changed: a smaller header and a smaller Pro notice on the settings screen.
 * Accessibility: the settings screen announces preview updates and check results
   in one short message, color pickers are named after the color they set, and every
   section stays usable without JavaScript.
 * For developers: new filters `aritoc_settings_schema` and `aritoc_sanitize_settings`.

#### 2.0.2

 * Fixed: importing a settings file failed on Windows servers (XAMPP, Laragon, IIS).
 * Fixed: a table placed above the post (sidebar or template) or linking to another
   page of a paginated post could point to the wrong anchor for headings with typographic
   characters such as “1920×1080”.
 * Fixed: the default title now follows each visitor’s language. Leave the Title
   field empty to use it.
 * Fixed: the stylesheet no longer loads on pages without a table on classic themes.
 * Fixed: screen readers announce the table as a list in Safari, and the optional“#”
   heading link no longer repeats in the heading’s spoken name.
 * Changed: the notice about another active table of contents plugin shows only 
   on the AriTOC settings screen.
 * Changed: “Delete all data” now also removes the widget settings and works on 
   every site of a multisite network.

#### 2.0.1

 * Fixed: “Settings saved.” appeared twice, inside the page header, after saving
   the settings.

#### 2.0.0

 * New: AriTOC block with a live preview, also usable in block theme templates and
   sidebars.
 * New: one table for paginated posts, with headings from every page.
 * New: shortcode options, per-page title, levels and exclusions.
 * New: import settings from Easy Table of Contents, Table of Contents Plus and 
   LuckyWP, and keep their shortcodes working.
 * New: roman, letter, per-level and bullet numbering; inherit and custom color 
   themes; floating alignment; two columns.
 * New: anchor formats and prefix, optional “#” heading links, option to keep the
   address bar clean.
 * New: settings screen with tabs and a live preview; export and import settings.
 * New: Rank Math table of contents detection.
 * Fixed: the table did not appear on block themes.
 * Fixed: sub-headings nested under the wrong parent when a level was skipped (H2,
   H4, H3).
 * Fixed: a generated anchor could clash with another element’s id.
 * Fixed: “Start collapsed” hid the table for visitors without JavaScript. Collapsing
   now uses the details element.
 * Fixed: the widget linked to anchors that did not exist on post types without 
   automatic insertion.
 * Changed: settings are kept when the plugin is deleted, unless you choose otherwise
   in Tools.

#### 1.1.0

 * Added extension hooks (aritoc_classes, aritoc_attributes) and a JavaScript init
   method for add-ons.
 * The gradient theme now follows the background color variable.

#### 1.0.0

 * First release.

## Meta

 *  Version **2.1.0**
 *  Last updated **6 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.3 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [block](https://wordpress.org/plugins/tags/block/)[headings](https://wordpress.org/plugins/tags/headings/)
   [navigation](https://wordpress.org/plugins/tags/navigation/)[table of contents](https://wordpress.org/plugins/tags/table-of-contents/)
   [toc](https://wordpress.org/plugins/tags/toc/)
 *  [Advanced View](https://wordpress.org/plugins/aritoc/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/aritoc/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/aritoc/reviews/)

## Contributors

 *   [ AriHub ](https://profiles.wordpress.org/arihub/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/aritoc/)