Title: NanoTOC — Fast Lightweight Table of Contents
Author: hanifsaqib
Published: <strong>January 7, 2026</strong>
Last modified: January 7, 2026

---

Search plugins

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

![](https://ps.w.org/nanotoc/assets/icon-256x256.png?rev=3433993)

# NanoTOC — Fast Lightweight Table of Contents

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

[Download](https://downloads.wordpress.org/plugin/nanotoc.1.0.0.zip)

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

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

## 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

![](https://secure.gravatar.com/avatar/6a333dd8dd5074c1b418b1a6376d24be00e43f628aacbe34fefdda1c5deabb8b?
s=60&d=retro&r=g)

### 󠀁[Simple, fast, and clean, exactly what i was looking for](https://wordpress.org/support/topic/simple-fast-and-clean-exactly-what-i-was-looking-for/)󠁿

 [alikhan54](https://profiles.wordpress.org/alikhan54/) January 7, 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 ](https://wordpress.org/support/plugin/nanotoc/reviews/)

## Contributors & Developers

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

Contributors

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

[Translate “NanoTOC — Fast Lightweight Table of Contents” into your language.](https://translate.wordpress.org/projects/wp-plugins/nanotoc)

### Interested in development?

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

## Changelog

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.0.0**
 *  Last updated **3 months ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.0 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.2 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/nanotoc/)
 * Tags
 * [headings](https://pcd.wordpress.org/plugins/tags/headings/)[lightweight](https://pcd.wordpress.org/plugins/tags/lightweight/)
   [smooth scroll](https://pcd.wordpress.org/plugins/tags/smooth-scroll/)[table of contents](https://pcd.wordpress.org/plugins/tags/table-of-contents/)
   [toc](https://pcd.wordpress.org/plugins/tags/toc/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/nanotoc/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/nanotoc/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/nanotoc/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/nanotoc/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/nanotoc/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/nanotoc/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/nanotoc/reviews/#new-post)

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

## Contributors

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

## Support

Got something to say? Need help?

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