Description
Post Hierarchy Nav is a lightweight Gutenberg block that renders clean, semantic navigation trees based on your existing post hierarchy. Perfect for documentation sites, knowledge bases, or any site using hierarchical content.
✨ Features
✅ Works with posts, pages, and any hierarchical custom post type
✅ Three display modes: All, Auto (current context), or Custom root
✅ Live preview via ServerSideRender — see changes instantly in the editor
✅ Optional child count badge (e.g., “Integrations 2”)
✅ Fully customizable CSS classes for root and active items
✅ Respects WordPress permissions and core data APIs
🎯 Use Cases
- Create auto-expanding documentation menus
- Build context-aware sidebars that highlight the current page’s branch
- Replace hardcoded menus with dynamic, maintainable trees
🔐 Privacy & Performance
- Zero tracking — no data collected, no external requests
- Lightweight — only loads when the block is used
- GDPR compliant by design
Blocks
This plugin provides 1 block.
- Hierarchy Nav Displays a hierarchical navigation tree of posts or custom post types.
Installation
- Upload the
post-hierarchy-navfolder to your/wp-content/plugins/directory. - Activate the plugin through the Plugins menu in WordPress.
- Add the Post Hierarchy Nav block to any post or page.
- Configure post type, mode, and styling in the block inspector.
FAQ
-
Does it work with custom post types?
-
Yes! As long as your CPT is registered with
'hierarchical' => trueand'show_in_rest' => true. -
How is the “Auto” mode determined?
-
It finds the top-level ancestor of the current page/post and renders its subtree.
-
Can I style the active item?
-
Yes! Use the “Active item CSS class” field in the Advanced panel (defaults to
active). -
Why require WordPress 6.3+?
-
The block uses modern Gutenberg APIs (
core-data,EntityPicker,ServerSideRender) that are stable from WP 6.3 onward. -
Where is the developer version hosted?
-
The developer version is available here.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Post Hierarchy Nav” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Post Hierarchy Nav” 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