diff --git a/settings/global.mdx b/settings/global.mdx
index 9d8bd473b..a1d24fdd2 100644
--- a/settings/global.mdx
+++ b/settings/global.mdx
@@ -538,6 +538,9 @@ Every documentation site requires a `docs.json` file that contains the core conf
         <ResponseField name="languages" type="array of string">
           Example languages for the autogenerated API snippets
         </ResponseField>
+         <ResponseField name="defaults" type="&quot;required&quot; | &quot;all&quot;">
+          Whether to show optional parameters in api examples, defaults to `all`
+        </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="mdx" type="object">