Document directory listings for navigation groups

[mintlify]

Summary

• Documents the new directory property that enables automatic directory listings on group root pages, with "accordion" (list-style) and "card" (horizontal cards) layout options
• Updates the navigation guide, site structure reference, and schema reference pages

What shipped

Navigation groups with a root page can now display an automatic directory of their child pages. Setting directory to "accordion" or "card" on any navigation node renders this UI on eligible root pages. The value inherits recursively through descendants, and can be overridden at any level with "none" to opt out.

---

Note

Low Risk
Documentation-only changes that add a new documented navigation.directory option and examples; no runtime or schema enforcement code is modified.

Overview
Documents a new directory property for navigation nodes to render automatic directory listings on group root pages, including inheritance/override behavior and the supported styles ("none", "accordion", "card").

Updates the docs.json references (settings-reference.mdx and settings-structure.mdx) to include navigation.directory in the quick reference and full property descriptions, with a link back to the new Navigation guide section.

^{Reviewed by Cursor Bugbot for commit f88bc4c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Apr 9, 2026, 5:24 AM

[ethanpalm]

Closing as duplicate of #5200. #5200 is the in-progress directory listings PR that will be reviewed when ready.