From f186fc9dddff9c62fbb7263210ca549da733aaee Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:10:13 +0000 Subject: [PATCH 01/14] Update organize/navigation.mdx --- organize/navigation.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 847fef149..f3576bf8a 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -7,7 +7,11 @@ The [navigation](organize/settings#param-navigation) property in `docs.json` con With proper navigation configuration, you can organize your content so that users can find exactly what they're looking for. -## Pages +## Basic navigation components + +These are the fundamental building blocks for organizing your documentation. + +### Pages Pages are the most fundamental navigation component. Pages map to the MDX files that make up your documentation. From 766fd83a0da451df1ffff4ca948670d0408546f4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:10:25 +0000 Subject: [PATCH 02/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index f3576bf8a..854b91478 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -43,7 +43,7 @@ In the `navigation` object, `pages` is an array where each entry must reference } ``` -## Groups +### Groups Use groups to organize your sidebar navigation into sections. Groups can be nested within each other, labeled with tags, and styled with icons. From 47b53642b5d841940ad2a4606b5be21167a97f38 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:10:38 +0000 Subject: [PATCH 03/14] Update organize/navigation.mdx --- organize/navigation.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 854b91478..7a52ceb76 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -107,7 +107,11 @@ Set `expanded: true` on a group to make it expanded by default in the navigation } ``` -## Tabs +## Top-level navigation structures + +These components create major divisions in your documentation and appear at the top level of your navigation hierarchy. + +### Tabs Tabs create distinct sections of your documentation with separate URL paths. Tabs create a horizontal navigation bar at the top of your documentation that lets users switch between sections. From d96d5c087d24207a23dbf3da1d7f5bf0a5cdbb35 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:10:52 +0000 Subject: [PATCH 04/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 7a52ceb76..d768c6204 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -161,7 +161,7 @@ In the `navigation` object, `tabs` is an array where each entry is an object tha } ``` -### Menus +#### Menus within tabs Menus add dropdown navigation items to a tab. Use menus to help users go directly to specific pages within a tab. From 5ee8fc8369c6d42ced24608a6aece7c9a80db5eb Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:01 +0000 Subject: [PATCH 05/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index d768c6204..77ffdf762 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -207,7 +207,7 @@ In the `navigation` object, `menu` is an array where each entry is an object tha } ``` -## Anchors +### Anchors Anchors add persistent navigation items to the top of your sidebar. Use anchors to section your content, provide quick access to external resources, or create prominent calls to action. From 066f4f54c8f13e33bebaff3ee4933b2e361afff5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:07 +0000 Subject: [PATCH 06/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 77ffdf762..85cde0ae4 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -282,7 +282,7 @@ Global anchors are particularly useful for linking to resources that are not par } ``` -## Dropdowns +### Dropdowns Dropdowns are contained in an expandable menu at the top of your sidebar navigation. Each item in a dropdown directs to a section of your documentation. From 2791e490dbcf2588b76a7b7f1625e09e9b2b8674 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:13 +0000 Subject: [PATCH 07/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 85cde0ae4..909afa475 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -331,7 +331,7 @@ In the `navigation` object, `dropdowns` is an array where each entry is an objec } ``` -## Products +### Products Date: Tue, 28 Oct 2025 17:11:22 +0000 Subject: [PATCH 08/14] Update organize/navigation.mdx --- organize/navigation.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 909afa475..7d95aa92d 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -395,7 +395,11 @@ In the `navigation` object, `products` is an array where each entry is an object } ``` -## OpenAPI +## Advanced features + +These features provide specialized functionality for complex documentation needs. + +### OpenAPI integration Integrate OpenAPI specifications directly into your navigation structure to automatically generate API documentation. Create dedicated API sections or place endpoint pages within other navigation components. From 9386e40cc0b93bafab95af545dc84b483387f8e4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:28 +0000 Subject: [PATCH 09/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 7d95aa92d..ff11d6867 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -434,7 +434,7 @@ Set a default OpenAPI specification at any level of your navigation hierarchy. C For more information about referencing OpenAPI endpoints in your docs, see the [OpenAPI setup](/api-playground/openapi-setup). -## Versions +### Versions Partition your navigation into different versions. Versions are selectable from a dropdown menu. From 75a444ec16b88360f4950320753b45b149828dda Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:34 +0000 Subject: [PATCH 10/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index ff11d6867..b21bccf43 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -479,7 +479,7 @@ In the `navigation` object, `versions` is an array where each entry is an object } ``` -## Languages +### Languages Partition your navigation into different languages. Languages are selectable from a dropdown menu. From af735d939d71b1d9c3494f176f21b9517e20d379 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:41 +0000 Subject: [PATCH 11/14] Update organize/navigation.mdx --- organize/navigation.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index b21bccf43..50c0ab003 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -545,7 +545,11 @@ We currently support the following languages for localization: For automated translations, [contact our sales team](mailto:gtm@mintlify.com) to discuss solutions. -## Nesting +## Navigation patterns + +Learn how to combine navigation components and configure their behavior. + +### Nesting components You can use any combination of anchors, tabs, dropdowns, and products. The components can be nested within each other interchangeably to create your desired navigation structure. From 5d32665d5e2947027b847082803a98f840de882b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:11:48 +0000 Subject: [PATCH 12/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 50c0ab003..9fcaad5c8 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -671,7 +671,7 @@ You can use any combination of anchors, tabs, dropdowns, and products. The compo -## Breadcrumbs +### Breadcrumbs Breadcrumbs display the full navigation path at the top of pages. Some themes have breadcrumbs enabled by default and others do not. You can control whether breadcrumbs are enabled for your site using the `styling` property in your `docs.json`. From 2acb94f78ee4f520d9c148887a5387e8e833d614 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:12:24 +0000 Subject: [PATCH 13/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 9fcaad5c8..aab2cbf05 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -691,7 +691,7 @@ Breadcrumbs display the full navigation path at the top of pages. Some themes ha -## Interaction configuration +### Interaction configuration Control how users interact with navigation elements using the `interaction` property in your `docs.json`. From 0df665e1eb3a2ee2a8984e2a15776ee8e0dba57a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Oct 2025 17:12:33 +0000 Subject: [PATCH 14/14] Update organize/navigation.mdx --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index aab2cbf05..bb5acaf7f 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -695,7 +695,7 @@ Breadcrumbs display the full navigation path at the top of pages. Some themes ha Control how users interact with navigation elements using the `interaction` property in your `docs.json`. -### Enable auto-navigation for groups +#### Auto-navigation for groups When a user expands a navigation group, some themes will automatically navigate to the first page in the group. You can override a theme's default behavior using the `drilldown` option.