NanoTOC — Fast Lightweight Table of Contents

Plugin Banner

NanoTOC — Fast Lightweight Table of Contents

by hanifsaqib

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

  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.
  1. NanoTOC displayed above a post.

    NanoTOC displayed above a post.

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)

1.0.0

  • Initial release.
Back to top