diff --git a/guides/claude-code.mdx b/guides/claude-code.mdx
index e0b53bc55..cb30c28d5 100644
--- a/guides/claude-code.mdx
+++ b/guides/claude-code.mdx
@@ -49,6 +49,10 @@ Copy this example template or make changes for your docs specifications:
 - Check existing patterns for consistency
 - Start by making the smallest reasonable changes
 
+## docs.json
+
+- Refer to the [docs.json schema](https://mintlify.com/docs.json) when building the docs.json file and site navigation
+
 ## Frontmatter requirements for pages
 - title: Clear, descriptive page title
 - description: Concise summary for SEO/navigation
diff --git a/guides/cursor.mdx b/guides/cursor.mdx
index 7c8d6e689..862c1441f 100644
--- a/guides/cursor.mdx
+++ b/guides/cursor.mdx
@@ -68,6 +68,10 @@ You are an AI writing assistant specialized in creating exceptional technical do
 
 ## Mintlify component reference
 
+### docs.json
+
+- Refer to the [docs.json schema](https://mintlify.com/docs.json) when building the docs.json file and site navigation
+
 ### Callout components
 
 #### Note - Additional helpful information
diff --git a/guides/windsurf.mdx b/guides/windsurf.mdx
index 3bdbb65e7..ed2d80814 100644
--- a/guides/windsurf.mdx
+++ b/guides/windsurf.mdx
@@ -62,6 +62,10 @@ description: "Concise description for SEO and navigation"
 
 ## Mintlify components
 
+### docs.json
+
+- Refer to the [docs.json schema](https://mintlify.com/docs.json) when building the docs.json file and site navigation
+
 ### Callouts
 
 - `<Note>` for helpful supplementary information