NanoTOC — Fast Lightweight Table of Contents

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+).

Screenshots

  • NanoTOC displayed above a post.

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)

Reviews

07 Janoary 2026
I tried this plugin expecting something basic, but it honestly surprised me. Setup was quick, it didn’t slow down my site, and it does exactly what it promises without unnecessary options. The interface feels clean and beginner-friendly, yet powerful enough for real use. I’ve tested it on a live site and everything works smoothly so far. Definitely keeping this one active.
Read all 1 review

Contributors & Developers

“NanoTOC — Fast Lightweight Table of Contents” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.