Skip to content

Show full navigation tree of a hidden section #14980

@chris-nowicki

Description

@chris-nowicki

Component

Docs

Priority

P2 - Medium (Would be helpful)

SDK Language(s)

No response

Feature Description

When navigating to a hidden section that contains multiple levels of nested subsections, the sidebar only renders the first level of children. Deeper subsections are not visible, meaning users must know the exact URL path to reach any nested content. This makes hidden sections with complex hierarchies difficult to navigate.

Add a showFullNav option in the section's .yml configuration that, when set to true, renders the full nested subtree in the sidebar for that section:

- section: Advanced Configuration
  hidden: true
  showFullNav: true
  contents:
    - section: Auth
      ...
    - section: Webhooks
      ...

This would cascade the full navigation tree for that section and all its descendants, making the sidebar fully explorable without requiring users to know exact URL paths in advance.

Why this matters

For large documentation sites with many nested hidden sections (e.g. admin or internal docs), discoverability is severely limited today. This option provides a flexible, opt-in way to expose the full navigation hierarchy without changing the section's hidden status.

Any alternatives?

Manually linking to subsections from a landing page works as a workaround but doesn't scale well for sections with 20+ nested pages.

Are you interested in contributing this feature?

No

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions