Nested pages (pages nested under pages)

[RiskeyL]

Current Limitation

Mintlify currently only supports nesting pages under group names (non-page entries), which creates architectural constraints when building intuitive documentation hierarchies.

Problem Description

Scenario: When documenting a concept with sub-concepts (e.g., a feature with variants), the ideal structure would be:

📄 A (main page about concept A)
├── 📄 A1 (sub-page about variant A1)
└── 📄 A2 (sub-page about variant A2)

Current Workaround: We must create a group structure like:

📁 A (group name, not a page)
├── 📄 A (overview page - confusing naming)
├── 📄 A1 (sub-page)
└── 📄 A2 (sub-page)

Issues with Current Approach

• Hierarchy confusion: A1 and A2 appear as siblings to A instead of children.
• Navigation UX: Users expect to click the group name "A" to learn about A, then explore sub-topics.
• Content organization: Forces artificial separation between overview and sub-topics.

Proposed Solution

Allow pages to have child pages directly.

Expected Benefits

• More intuitive information architecture
• Better user navigation experience
• Cleaner, more logical documentation structure
• Reduced cognitive load for both authors and readers

[alexakreizinger]

💯 I would really love to see this implemented—my team recently migrated to Mintlify and the fact that we can't use actual pages as group landing pages has thrown a serious wrench in our UX/information architecture, especially since our docs often have multiple sub-layers of nesting. (and I hate to be that person, but I think this is a standard feature supported by most documentation tools :P)

for example, in our old docs site, navigating several layers deep into a nested section would show something like this (where each item, including "parent" items, was a link to a doc):

Instruments
├── Strings
│   ├── Violin
│   │   ├── Tuning
│   │   ├── Maintenance
│   │   ├── Sheet music
│   │   │   ├── Free sheet music
│   │   │   └── Premium sheet music
│   │   └── Troubleshooting
│   ├── Viola
│   └── Cello
├── Woodwinds
└── Percussion

since then, we've had to add a number of "overview" pages to retain the same amount of information as before, but this results in a much longer and more cluttered navigation architecture:

Instruments
├── Overview
├── Strings
│   ├── Overview
│   ├── Violin
│   │   ├── Overview
│   │   ├── Tuning
│   │   ├── Maintenance
│   │   ├── Sheet music
│   │   │   ├── Overview
│   │   │   ├── Free sheet music
│   │   │   └── Premium sheet music
│   │   └── Troubleshooting
│   ├── Viola
│   └── Cello
├── Woodwinds
└── Percussion