{"id":404914,"date":"2026-11-19T21:17:22","date_gmt":"2026-11-19T21:17:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/aritoc-table-of-contents-by-arihub\/"},"modified":"2026-11-19T21:17:08","modified_gmt":"2026-11-19T21:17:08","slug":"aritoc","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/aritoc\/","author":23589628,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.0","stable_tag":"2.1.0","tested":"7.1.5","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"AriTOC","header_author":"AriHub","header_description":"A fast, accessible table of contents for posts, pages and custom post types. Automatic, block, shortcode or widget. Works without jQuery, on block and classic themes, and on paginated posts.","last_updated":"2026-11-19 21:17:08","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.arihub.com\/aritoc\/","header_author_uri":"https:\/\/www.arihub.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":36,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.1.0":{"tag":"2.1.0","author":"arihub","date":"2026-11-19 21:17:08","revision":3812507}},"upgrade_notice":{"2.1.0":"<p>New settings screen with page checks: see why a page has or has no table.<\/p>","2.0.0":"<p>Block, paginated posts, migration from other TOC plugins and many fixes, including block theme support.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3812507,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3812507,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3812507,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3812507,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3812507,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"aritoc\/toc":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"aritoc\/toc","title":"Table of Contents (AriTOC)","category":"widgets","icon":"list-view","description":"Lists the headings of the post with links to each section. Place it in a post, or in a theme template or sidebar.","keywords":["toc","contents","headings","index","aritoc"],"textdomain":"aritoc","attributes":{"title":{"type":"string","default":""},"showTitle":{"type":"string","default":""},"levels":{"type":"array","items":{"type":"number"},"default":[]},"exclude":{"type":"string","default":""},"numbering":{"type":"string","default":""},"theme":{"type":"string","default":""},"collapsible":{"type":"string","default":""},"collapsed":{"type":"string","default":""},"hierarchical":{"type":"string","default":""},"minHeadings":{"type":"number","default":0}},"supports":{"html":false,"multiple":true,"reusable":true},"editorScript":"aritoc-block-editor","editorStyle":"aritoc"}},"tagged_versions":["2.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3812507,"resolution":"1","location":"assets","locale":"","width":1200,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3812507,"resolution":"2","location":"assets","locale":"","width":1200,"height":720},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3812507,"resolution":"3","location":"assets","locale":"","width":1280,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3812507,"resolution":"4","location":"assets","locale":"","width":1280,"height":820},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3812507,"resolution":"5","location":"assets","locale":"","width":780,"height":1688},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3812507,"resolution":"6","location":"assets","locale":"","width":1280,"height":900}},"screenshots":{"1":"The table inserted automatically before the first heading, with the section being read highlighted.","2":"Built-in looks: light, dark, AriHub gradient, minimal and custom colors, with six numbering styles.","3":"Settings grouped by task, with a live preview that can use one of your own pages.","4":"Tools: copy settings from another table of contents plugin, keep its shortcodes working, export, import or reset settings.","5":"On a phone: the table fits the screen and collapses with a tap.","6":"Check a page: see whether a page gets a table, and why each heading is listed or skipped."}},"plugin_section":[],"plugin_tags":[1220,19897,1753,10851,10852],"plugin_category":[43],"plugin_contributors":[289004],"plugin_business_model":[],"class_list":["post-404914","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-headings","plugin_tags-navigation","plugin_tags-table-of-contents","plugin_tags-toc","plugin_category-customization","plugin_contributors-arihub","plugin_committers-arihub","plugin_committers-cartoonistarif","plugin_support_reps-cartoonistarif"],"banners":{"banner":"https:\/\/ps.w.org\/aritoc\/assets\/banner-772x250.png?rev=3812507","banner_2x":"https:\/\/ps.w.org\/aritoc\/assets\/banner-1544x500.png?rev=3812507","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/aritoc\/assets\/icon.svg?rev=3812507","icon":"https:\/\/ps.w.org\/aritoc\/assets\/icon.svg?rev=3812507","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-1.png?rev=3812507","caption":"The table inserted automatically before the first heading, with the section being read highlighted."},{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-2.png?rev=3812507","caption":"Built-in looks: light, dark, AriHub gradient, minimal and custom colors, with six numbering styles."},{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-3.png?rev=3812507","caption":"Settings grouped by task, with a live preview that can use one of your own pages."},{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-4.png?rev=3812507","caption":"Tools: copy settings from another table of contents plugin, keep its shortcodes working, export, import or reset settings."},{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-5.png?rev=3812507","caption":"On a phone: the table fits the screen and collapses with a tap."},{"src":"https:\/\/ps.w.org\/aritoc\/assets\/screenshot-6.png?rev=3812507","caption":"Check a page: see whether a page gets a table, and why each heading is listed or skipped."}],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<h4>Place it the way you like<\/h4>\n\n<ul>\n<li><strong>Automatically<\/strong> 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.<\/li>\n<li><strong>Block<\/strong>: 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.<\/li>\n<li><strong>Shortcode<\/strong> <code>[aritoc]<\/code> with options for title, levels, exclusions, numbering, theme and more.<\/li>\n<li><strong>Widget<\/strong> for classic theme sidebars.<\/li>\n<li><strong>Template tag<\/strong> <code>aritoc()<\/code> for theme developers.<\/li>\n<\/ul>\n\n<h4>Made for real content<\/h4>\n\n<ul>\n<li><strong>Paginated posts<\/strong>: posts split with the Page Break block (<code>&lt;!--nextpage--&gt;<\/code>) get one table with the headings of every page, linking across pages.<\/li>\n<li><strong>Block themes and classic themes<\/strong>: works with Twenty Twenty-Five and other block themes as well as classic themes.<\/li>\n<li><strong>Any language<\/strong>: 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.<\/li>\n<li>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).<\/li>\n<li>Skip headings by text (with * wildcards), by CSS class, or give one heading the class <code>no-toc<\/code>.<\/li>\n<li>Show a shorter label in the table with <code>data-aritoc-label<\/code> on the heading.<\/li>\n<li>Headings inside code, scripts and forms are ignored.<\/li>\n<\/ul>\n\n<h4>Looks good everywhere<\/h4>\n\n<ul>\n<li>Light, dark, automatic (follows the visitor's device), AriHub gradient, minimal, inherit-your-theme and custom colors.<\/li>\n<li>Nested numbers (1, 1.1), numbers per level, roman numerals, letters, bullets or none.<\/li>\n<li>Fit to content, full or medium width; centered or floating left or right with text wrapping around.<\/li>\n<li>Two columns for long tables on wide screens.<\/li>\n<li>Live preview on the settings screen as you change options.<\/li>\n<li>Right-to-left languages supported.<\/li>\n<\/ul>\n\n<h4>Tells you why<\/h4>\n\n<p>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.<\/p>\n\n<h4>Fast and accessible<\/h4>\n\n<ul>\n<li>One small stylesheet and one small deferred script, only on pages that show a table. No jQuery.<\/li>\n<li>Collapsing uses the browser's own details element: it works without JavaScript, with the keyboard and with screen readers.<\/li>\n<li>Labelled navigation landmark, <code>aria-current<\/code> on the section being read, and focus moves to the heading after a click.<\/li>\n<li>Smooth scrolling that respects the reduced-motion setting, and a scroll offset for sticky headers.<\/li>\n<li>Optional: keep the address bar clean (no #section added on click).<\/li>\n<li>Optional \"#\" link next to each heading so readers can copy a link to that section.<\/li>\n<li>Print friendly: collapsed tables are printed in full.<\/li>\n<\/ul>\n\n<h4>Switch from another plugin in one click<\/h4>\n\n<p>Moving from Easy Table of Contents, Table of Contents Plus or LuckyWP Table of Contents? Settings &gt; AriTOC &gt; Tools copies their settings and keeps their shortcodes (<code>[toc]<\/code>, <code>[ez-toc]<\/code>, <code>[lwptoc]<\/code>, <code>[no_toc]<\/code>) working with AriTOC, so you do not have to edit any post. Easy Table of Contents' \"disable on this post\" choices are respected too.<\/p>\n\n<h4>Works with<\/h4>\n\n<ul>\n<li>Rank Math: the \"Use a table of contents\" check passes with AriTOC.<\/li>\n<li>Any editor or page builder that prints content through the standard <code>the_content<\/code> filter. Elsewhere, use the shortcode or block.<\/li>\n<\/ul>\n\n<h4>Per-page control<\/h4>\n\n<p>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.<\/p>\n\n<h4>AriTOC Pro<\/h4>\n\n<p>AriTOC Pro is a separate add-on from <a href=\"https:\/\/www.arihub.com\/aritoc\/\">arihub.com<\/a>. 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.<\/p>\n\n<h3>Developers<\/h3>\n\n<p>Filters: <code>aritoc_reserved_ids<\/code>, <code>aritoc_settings<\/code>, <code>aritoc_settings_schema<\/code>, <code>aritoc_sanitize_settings<\/code>, <code>aritoc_auto_insert<\/code>, <code>aritoc_add_anchors<\/code>, <code>aritoc_enqueue<\/code>, <code>aritoc_heading<\/code>, <code>aritoc_anchor<\/code>, <code>aritoc_items<\/code>, <code>aritoc_classes<\/code>, <code>aritoc_attributes<\/code>, <code>aritoc_title_after<\/code>, <code>aritoc_html<\/code>, <code>aritoc_page_html<\/code>, <code>aritoc_post_mode<\/code>.<\/p>\n\n<p>Functions: <code>aritoc( $args )<\/code>, <code>aritoc_get( $args, $post )<\/code>, <code>aritoc_get_headings( $post )<\/code>.<\/p>\n\n<p>JavaScript: <code>window.AriTOC.init( element )<\/code>, and the <code>aritoc:active<\/code> and <code>aritoc:jump<\/code> events.<\/p>\n\n<p>CSS custom properties on <code>.aritoc<\/code>: <code>--aritoc-bg<\/code>, <code>--aritoc-fg<\/code>, <code>--aritoc-mut<\/code>, <code>--aritoc-line<\/code>, <code>--aritoc-link<\/code>, <code>--aritoc-act<\/code>, <code>--aritoc-rad<\/code>, <code>--aritoc-gap<\/code>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install AriTOC from Plugins &gt; Add New, or upload the <code>aritoc<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate it.<\/li>\n<li>Go to Settings &gt; AriTOC to choose where and how the table appears.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"why%20does%20a%20page%20show%20no%20table%3F\"><h3>Why does a page show no table?<\/h3><\/dt>\n<dd><p>Go to Settings &gt; AriTOC &gt; 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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20skip%20one%20heading%3F\"><h3>How do I skip one heading?<\/h3><\/dt>\n<dd><p>Select the heading in the block editor, open Advanced and add the CSS class <code>no-toc<\/code>.<\/p><\/dd>\n<dt id=\"my%20sticky%20header%20covers%20the%20heading%20after%20clicking\"><h3>My sticky header covers the heading after clicking<\/h3><\/dt>\n<dd><p>Set \"Scroll offset\" in Settings &gt; AriTOC &gt; Behavior to the height of your header.<\/p><\/dd>\n<dt id=\"can%20i%20use%20the%20shortcode%20options%3F\"><h3>Can I use the shortcode options?<\/h3><\/dt>\n<dd><p>Yes: <code>[aritoc title=\"In this article\" levels=\"2,3\" exclude=\"FAQ|Related*\" numbering=\"roman\" theme=\"dark\" collapsible=\"yes\" collapsed=\"no\" hierarchical=\"yes\" class=\"my-toc\"]<\/code>. Anything you leave out uses the settings page.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20my%20page%20builder%3F\"><h3>Does it work with my page builder?<\/h3><\/dt>\n<dd><p>When the builder prints content through <code>the_content<\/code>, the automatic table works. Otherwise add the <code>[aritoc]<\/code> shortcode where you want the table.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20my%20data%20if%20i%20delete%20the%20plugin%3F\"><h3>What happens to my data if I delete the plugin?<\/h3><\/dt>\n<dd><p>Settings are kept unless you tick \"Delete all AriTOC settings\" in Settings &gt; AriTOC &gt; Tools.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>New: Overview tab with a plain-language summary of how AriTOC works on your site.<\/li>\n<li>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.<\/li>\n<li>New: preview the table with one of your own pages, not only sample headings.<\/li>\n<li>New: save bar that shows unsaved changes and warns before you leave, and \"Reset to defaults\" in Tools.<\/li>\n<li>New: low-contrast warning for custom colors.<\/li>\n<li>Changed: settings are grouped into Placement, Headings, Appearance and Navigation; \"Start collapsed\" is only available when collapsing is on.<\/li>\n<li>Changed: the editor box option \"Always show\" is now \"Show on this page (when it has enough headings)\", which is what it always did.<\/li>\n<li>Changed: a smaller header and a smaller Pro notice on the settings screen.<\/li>\n<li>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.<\/li>\n<li>For developers: new filters <code>aritoc_settings_schema<\/code> and <code>aritoc_sanitize_settings<\/code>.<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Fixed: importing a settings file failed on Windows servers (XAMPP, Laragon, IIS).<\/li>\n<li>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 \"1920x1080\".<\/li>\n<li>Fixed: the default title now follows each visitor's language. Leave the Title field empty to use it.<\/li>\n<li>Fixed: the stylesheet no longer loads on pages without a table on classic themes.<\/li>\n<li>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.<\/li>\n<li>Changed: the notice about another active table of contents plugin shows only on the AriTOC settings screen.<\/li>\n<li>Changed: \"Delete all data\" now also removes the widget settings and works on every site of a multisite network.<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Fixed: \"Settings saved.\" appeared twice, inside the page header, after saving the settings.<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>New: AriTOC block with a live preview, also usable in block theme templates and sidebars.<\/li>\n<li>New: one table for paginated posts, with headings from every page.<\/li>\n<li>New: shortcode options, per-page title, levels and exclusions.<\/li>\n<li>New: import settings from Easy Table of Contents, Table of Contents Plus and LuckyWP, and keep their shortcodes working.<\/li>\n<li>New: roman, letter, per-level and bullet numbering; inherit and custom color themes; floating alignment; two columns.<\/li>\n<li>New: anchor formats and prefix, optional \"#\" heading links, option to keep the address bar clean.<\/li>\n<li>New: settings screen with tabs and a live preview; export and import settings.<\/li>\n<li>New: Rank Math table of contents detection.<\/li>\n<li>Fixed: the table did not appear on block themes.<\/li>\n<li>Fixed: sub-headings nested under the wrong parent when a level was skipped (H2, H4, H3).<\/li>\n<li>Fixed: a generated anchor could clash with another element's id.<\/li>\n<li>Fixed: \"Start collapsed\" hid the table for visitors without JavaScript. Collapsing now uses the details element.<\/li>\n<li>Fixed: the widget linked to anchors that did not exist on post types without automatic insertion.<\/li>\n<li>Changed: settings are kept when the plugin is deleted, unless you choose otherwise in Tools.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added extension hooks (aritoc_classes, aritoc_attributes) and a JavaScript init method for add-ons.<\/li>\n<li>The gradient theme now follows the background color variable.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"A fast, accessible table of contents. Automatic, block, shortcode or widget. Works on block themes, paginated posts and without jQuery.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/404914","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=404914"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/arihub"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=404914"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=404914"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=404914"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=404914"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=404914"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=404914"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}