Document HTTP snippets enabled by default with configuration options (#1288)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Catherine Deskur <[email protected]>
Co-authored-by: Devin Logan <[email protected]>

Author: 3 people

fern/products/docs/pages/api-references/http-snippets.mdx

@@ -8,15 +8,24 @@ subtitle: HTTP snippets allow users to see API request examples using common HTT
 ![HTTP code snippet selector](./http-snippets.png)
 </Frame>
 
-## Setup
+## Configuration
 
-1. Ensure you have a paid Fern subscription
-2. Contact support to request HTTP snippets activation
-3. Once enabled, build your production docs
+HTTP snippets are enabled by default for all documentation sites. To disable snippets or enable only for certain languages, use the `settings.http-snippets` configuration in your `docs.yml` file:
 
-<Note>
-Currently, HTTP snippets are provided as an all-or-nothing set. You cannot configure which languages are displayed. If you would like this feature, please [open a GitHub issue](https://github.com/fern-api/fern/issues/new?template=docs-feature.yml).
-</Note>
+<CodeBlock title="docs.yml">
+
+```yaml
+# Turn off HTTP snippets for all languages
+settings:
+  http-snippets: false
+
+# Enable only for specific languages (here, only Python and Ruby)
+settings:
+  http-snippets:
+    - python
+    - ruby
+```
+</CodeBlock>
 
 ## How It Works
 

fern/products/docs/pages/changelog/2025-10-17.mdx

@@ -1,3 +1,23 @@
+## HTTP Snippets now enabled by default
+
+HTTP snippets are now enabled by default for all documentation sites, making it easier for developers to see cURL, Python, Ruby, and other HTTP client examples directly in your API reference. Previously, this feature required internal configuration to activate.
+
+You can now control HTTP snippets directly in your `docs.yml` file:
+
+```yaml title="docs.yml"
+# Turn off HTTP snippets
+settings:
+  http-snippets: false
+
+# Or specify only certain languages
+settings:
+  http-snippets:
+    - python
+    - ruby
+```
+
+Visit the [HTTP snippets documentation](/docs/api-references/http-snippets) to learn more. 
+
 ## Introducing Runnable Endpoint
 
 Test API endpoints directly from your documentation with our new interactive component. Runnable Endpoint allows your users to send real HTTP requests to your API without leaving your docs, making it easier for developers to explore and understand your API.

fern/products/docs/pages/customization/what-is-docs-yml.mdx

@@ -458,7 +458,7 @@ settings:
   disable-search: false
   dark-mode-code: true
   default-search-filters: true
-  http-snippets: true
+  http-snippets: false
   hide-404-page: true
   use-javascript-as-typescript: false
 ```
@@ -481,8 +481,19 @@ settings:
   If set to true, search will display results for pages within the current product and version.
 </ParamField>
 
-<ParamField path="settings.http-snippets" type="boolean" required={false} default="false" toc={true}>
-  If set to true, the HTTP snippets will be displayed in the API Reference.
+<ParamField path="settings.http-snippets" type="boolean | list of objects" required={false} default="true" toc={true}>
+  Controls the display of [HTTP snippets in the API Reference](/docs/api-references/http-snippets). HTTP snippets are enabled by default for all languages.
+  
+  - Set to `false` to disable HTTP snippets completely
+  - Provide a list of languages to enable snippets for specific languages only
+
+```yaml title="docs.yml"
+# Enable only for Python and Ruby
+settings:
+  http-snippets:
+    - python
+    - ruby
+```
 </ParamField>
 
 <ParamField path="settings.hide-404-page" type="boolean" required={false} default="false" toc={true}>