NanoTOC — Fast Lightweight Table of Contents

By hanifsaqib

★ 5.0/5 (1 ratings)0+ active installationsVersion 1.0.0

Fast, lightweight TOC for WordPress with nested/flat lists, smooth scroll, and optional offset.

Description

NanoTOC is a fast, lightweight table of contents plugin for WordPress.

License: GPLv2 or later.

Core features:

  • Select which headings to include (H1–H6)
  • Nested (hierarchical) or flat (linear) TOC output
  • Smooth scrolling to headings
  • Optional scroll offset for sticky headers
  • Works with posts, pages, and custom post types
  • Shortcode support: [nanotoc]

Created by Saqib Hanif.

License

NanoTOC is licensed under the GNU General Public License v2.0 or later (GPLv2+).

Installation

  1. Upload the plugin folder to /wp-content/plugins/nanotoc/.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Configure it via Settings → NanoTOC.

FAQ

How do I insert the TOC?

  • Enable Auto insert in Settings → NanoTOC, OR
  • Place the shortcode where you want it:

    [nanotoc]

How do I choose H2 only (or H2 + H3)?

Go to Settings → NanoTOC → Headings to include and select the levels.

My theme has a sticky header and headings are hidden after clicking

Increase the “Scroll offset (px)” setting. NanoTOC also adds the WordPress admin bar height automatically when you are logged in.

Can I style it with my theme?

Yes. NanoTOC does not ship heavy styles. Use these classes in your theme CSS:

  • .nanotoc
  • .nanotoc__title
  • .nanotoc__list
  • .nanotoc__item
  • .nanotoc__link

I found an issue / I want a feature

Please contact the author and share:

  • Your WordPress version
  • Your theme name
  • A short description (and a screenshot if possible)

Screenshots

Changelog

1.0.0

  • Initial release.