Skip to content

Pages missing in the section index of docs-only sites #2499

@adlerzei

Description

@adlerzei

Environment

  • Version of Docsy you are using: 0.13.0
  • How are you using Docsy? As a:
    • Hugo module
    • NPM module
    • Git submodule
    • Other: Fork
  • Version of Hugo you are using (output of hugo version): v0.155.0-74c0bbfc6abce6a4f568c2b8c593a7fca9710e3f+extended windows/amd64 BuildDate=2026-01-28T16:28:23Z
  • OS:
    • Linux
    • macOS
    • Windows
    • Other:

Problem

In docs-only sites, the section index (the formatted list of pages in the section) of the home page is not built correctly. It only lists pages that are direct children and not inside another section. For example in:

.
└── content/
    ├── _index.md
    ├── A/
    │   ├── _index.md
    │   └── B.md
    └── C.md

only C would be listed in the section index and A would be missed.

I created a sample project based on docsy.dev in adlerzei/docsy:top_level_section_bug_example where this issue can be seen:
Image

The nested section index pages are missing, e.g., "Get started" and "Content and Customization" are not listed.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions