Document default property for version navigation

organize/navigation.mdx

@@ -120,11 +120,11 @@
 
 Use the `expanded` property to control the default state of a nested group in the navigation sidebar.
 
 - `expanded: true`: Group is expanded by default.
 - `expanded: false` or omitted: Group is collapsed by default.
 
 <Note>
   The `expanded` property only affects nested groups--groups within groups. Top-level groups are always expanded and cannot be collapsed.
 </Note>
 
 ```json
@@ -515,6 +515,38 @@
 }
 ```
 
+### Default version
+
+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."
@@ -695,7 +727,7 @@
 
 ## Nesting
 
 Navigation elements can be nested within each other to create complex hierarchies. You must have one root-level parent navigation element such as tabs, groups, or a dropdown. You can nest other types of navigation elements within your primary navigation pattern.
 
 Each navigation element can contain one type of child element at each level of your navigation hierarchy. For example, a tab can contain anchors that contain groups, but a tab cannot contain both anchors and groups at the same level.
 

organize/settings.mdx

@@ -348,11 +348,11 @@
 </ResponseField>
 
 <ResponseField name="variables" type="object">
   Global variables for use throughout your documentation. Variables are replaced at build time using `{{variableName}}` syntax.
 
   <Expandable title="Variables">
     <ResponseField name="variableName" type="string">
       A key-value pair where the key is the variable name and the value is the replacement text. All variables referenced in your content must be defined, or the build fails. Variable names can contain alphanumeric characters, hyphens, and periods. Values are sanitized to prevent XSS attacks.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -559,6 +559,9 @@
       Version switcher for sites with multiple [versions](/organize/navigation#versions).
 
       <Expandable title="Versions">
+        <ResponseField name="default" type="boolean">
+          Set to `true` to make this version the default. If omitted or `false`, the first version in the array is the default.
+        </ResponseField>
         <ResponseField name="tag" type="string">
           Badge label displayed next to the version in the version selector. Use to highlight specific versions such as "Latest", "Recommended", or "Beta."
         </ResponseField>