diff --git a/navigation.mdx b/navigation.mdx
index 2c89326a0..e0844e2de 100644
--- a/navigation.mdx
+++ b/navigation.mdx
@@ -584,6 +584,34 @@ Style pages with breadcrumbs to display the full navigation path at the top of p
 }
 ```
 
+## Interaction Configuration
+
+Control how users interact with navigation elements using the `interaction` property in your `docs.json`.
+
+### Auto Navigation on Expand
+
+Different themes have different default behavior when clicking on navigation groups. You can override this behavior using the `drilldown` option:
+
+```json
+{
+  "interaction": {
+    "drilldown": true  // Force navigation to first page when a user expands a dropdown
+  }
+}
+```
+
+```json
+{
+  "interaction": {
+    "drilldown": false // Never navigate, only expand/collapse
+  }
+}
+```
+
+- Set to `true` to force automatic navigation to the first page when clicking navigation groups
+- Set to `false` to prevent navigation and only expand or collapse the group
+- Leave unset to use the theme's default behavior
+
 ## FAQ
 
 <Accordion title="What navigation folders should I avoid?">
diff --git a/settings.mdx b/settings.mdx
index a8ab4b7c2..80667699c 100644
--- a/settings.mdx
+++ b/settings.mdx
@@ -446,6 +446,16 @@ See [Themes](themes) for more information.
   </Expandable>
 </ResponseField>
 
+<ResponseField name="interaction" type="object">
+  User interaction settings for navigation elements.
+
+  <Expandable title="Interaction">
+    <ResponseField name="drilldown" type="boolean">
+      Control automatic navigation behavior when clicking on navigation groups. Set to `true` to force navigation to the first page when expanding groups, `false` to only expand/collapse without navigation, or leave unset to use the theme's default behavior.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
 <ResponseField name="footer" type="object">
   Footer content and social media links.