From 98901279108bfbcdaebe304af516fc3449d5c868 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 00:20:45 +0000 Subject: [PATCH 1/3] Document default property for version navigation Generated-By: mintlify-agent --- organize/navigation.mdx | 32 ++++++++++++++++++++++++++++++++ organize/settings.mdx | 3 +++ 2 files changed, 35 insertions(+) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 168b67763..9449bdb2d 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -515,6 +515,38 @@ In the `navigation` object, `versions` is an array where each entry is an object } ``` +### Default version + +By default, the first version in the `versions` array is used as the default version. Use the `default` field to specify a different version as the default. + +```json +{ + "navigation": { + "versions": [ + { + "version": "1.0.0", + "groups": [ + { + "group": "Getting started", + "pages": ["v1/overview", "v1/quickstart"] + } + ] + }, + { + "version": "2.0.0", + "default": true, + "groups": [ + { + "group": "Getting started", + "pages": ["v2/overview", "v2/quickstart"] + } + ] + } + ] + } +} +``` + ### Version tags Add a badge label to version entries in the version selector dropdown using the optional `tag` field. Use tags to highlight specific versions such as "Latest," "Recommended," or "Beta." diff --git a/organize/settings.mdx b/organize/settings.mdx index 3445eec64..5efffe20f 100644 --- a/organize/settings.mdx +++ b/organize/settings.mdx @@ -559,6 +559,9 @@ This section contains the full reference for the `docs.json` file. Version switcher for sites with multiple [versions](/organize/navigation#versions). + + Set to `true` to make this version the default. By default, the first version in the array is used. + Badge label displayed next to the version in the version selector. Use to highlight specific versions such as "Latest", "Recommended", or "Beta." From 63b651f7b64fc24d2a3789f47791263cd2baa1cc Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 10 Mar 2026 18:06:48 -0700 Subject: [PATCH 2/3] Apply suggestion from @ethanpalm --- organize/navigation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 9449bdb2d..467fddffa 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -517,7 +517,7 @@ In the `navigation` object, `versions` is an array where each entry is an object ### Default version -By default, the first version in the `versions` array is used as the default version. Use the `default` field to specify a different version as the default. +The first version in the `versions` array is used as the default version. Use the `default` field to specify a different version as the default. ```json { From 48fe18eb35c573f5d6e0a674c082ba0076b9c972 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 10 Mar 2026 18:07:42 -0700 Subject: [PATCH 3/3] Apply suggestion from @ethanpalm --- organize/settings.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/organize/settings.mdx b/organize/settings.mdx index 5efffe20f..bc8ed45a3 100644 --- a/organize/settings.mdx +++ b/organize/settings.mdx @@ -560,7 +560,7 @@ This section contains the full reference for the `docs.json` file. - Set to `true` to make this version the default. By default, the first version in the array is used. + Set to `true` to make this version the default. If omitted or `false`, the first version in the array is the default. Badge label displayed next to the version in the version selector. Use to highlight specific versions such as "Latest", "Recommended", or "Beta."