diff --git a/mint.json b/mint.json
index 0636b0312..b6e13a7db 100644
--- a/mint.json
+++ b/mint.json
@@ -122,7 +122,8 @@
     },
     {
       "group": "Advanced",
-      "pages": [{
+      "pages": [
+        {
           "icon": "code",
           "group": "Custom Scripts",
           "pages": [
@@ -196,7 +197,10 @@
     },
     {
       "group": "SDKs",
-      "pages": ["integrations/sdks/speakeasy", "integrations/sdks/stainless"]
+      "pages": [
+        "integrations/sdks/speakeasy",
+        "integrations/sdks/stainless"
+      ]
     },
     {
       "group": "Support",
@@ -208,7 +212,10 @@
     },
     {
       "group": "Privacy",
-      "pages": ["integrations/privacy/overview", "integrations/privacy/osano"]
+      "pages": [
+        "integrations/privacy/overview",
+        "integrations/privacy/osano"
+      ]
     },
     {
       "group": "Components",
@@ -240,7 +247,9 @@
     },
     {
       "group": "Changelog",
-      "pages": ["changelog/overview"]
+      "pages": [
+        "changelog/overview"
+      ]
     }
   ],
   "footer": {
@@ -324,4 +333,4 @@
       "publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8"
     }
   }
-}
+}
\ No newline at end of file
diff --git a/settings/versioning.mdx b/settings/versioning.mdx
index dbafd459c..f9f24f77c 100644
--- a/settings/versioning.mdx
+++ b/settings/versioning.mdx
@@ -111,4 +111,8 @@ Common errors and how to fix them
     navigation, make sure you spelled the version the same as in your `versions`
     array in `mint.json`.
   </Accordion>
-</AccordionGroup>
+
+  <Accordion title="Navigation Order Issues" icon="circle-exclamation">
+    If your version-specific pages are appearing in an unexpected order, check that the navigation order in your `mint.json` file matches for all versions. Pages will be displayed in the order they are listed in the navigation, regardless of their version.
+  </Accordion>
+</AccordionGroup>
\ No newline at end of file