diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx
index b2cb6c60f..ead65ed19 100644
--- a/fern/products/docs/pages/navigation/site-level-settings.mdx
+++ b/fern/products/docs/pages/navigation/site-level-settings.mdx
@@ -748,6 +748,7 @@ settings:
     prioritize-current-product: true
     default-filter-by-current-product: true
   http-snippets: false
+  show-headers-in-examples: false
   hide-404-page: true
   use-javascript-as-typescript: false
   folder-title-source: frontmatter
@@ -809,6 +810,10 @@ settings:
 ```
 </ParamField>
 
+<ParamField path="settings.show-headers-in-examples" type="boolean" required={false} default="false" toc={true}>
+  If set to true, response examples in the API Reference include a raw HTTP block listing the response's declared headers — the status line plus one `Name: value` line per header — above the response body. Responses whose spec declares no headers render unchanged.
+</ParamField>
+
 <ParamField path="settings.hide-404-page" type="boolean" required={false} default="false" toc={true}>
   If set to true, when a user navigates to a page that doesn't exist, they will be redirected to the home page.