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
- Upload the plugin folder to
/wp-content/plugins/nanotoc/. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- 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.
-
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
Contributors & Developers
“NanoTOC — Fast Lightweight Table of Contents” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “NanoTOC — Fast Lightweight Table of Contents” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.

