Document HTTP snippets enabled by default with configuration options

Co-Authored-By: Catherine Deskur <[email protected]>

Author: devin-ai-integration[bot]

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

@@ -8,15 +8,46 @@ 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 now enabled by default for all documentation sites. You can control this behavior using 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>
+### Enable all HTTP snippets (default)
+
+By default, all supported HTTP snippet languages will be displayed:
+
+<CodeBlock title="docs.yml">
+```yaml
+# HTTP snippets are enabled by default
+# No configuration needed
+```
+</CodeBlock>
+
+### Disable HTTP snippets
+
+To turn off HTTP snippets completely:
+
+<CodeBlock title="docs.yml">
+```yaml
+settings:
+  http-snippets: false
+```
+</CodeBlock>
+
+### Display specific languages
+
+To show only a subset of HTTP snippet languages, provide an array of language identifiers:
+
+<CodeBlock title="docs.yml">
+```yaml
+settings:
+  http-snippets:
+    - python
+    - ruby
+```
+</CodeBlock>
+
+This configuration will display only Python and Ruby HTTP snippets, excluding cURL and other languages.
 
 ## How It Works
 

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

@@ -0,0 +1,25 @@
+## 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
+# Turn off HTTP snippets
+settings:
+  http-snippets: false
+
+# Or specify only certain languages
+settings:
+  http-snippets:
+    - python
+    - ruby
+```
+
+If you don't specify any configuration, all HTTP snippet languages will be displayed by default.
+
+<Card
+  title="Learn more about HTTP snippets"
+  variant="bordered"
+  href="/docs/api-references/http-snippets"
+/>

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

@@ -481,8 +481,14 @@ 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 | array" required={false} default="true" toc={true}>
+  Controls the display of HTTP snippets in the API Reference. HTTP snippets are now enabled by default.
+  
+  - Set to `false` to disable HTTP snippets completely
+  - Set to `true` (or omit) to enable all HTTP snippet languages
+  - Provide an array of language identifiers (e.g., `["python", "ruby"]`) to display only specific languages
+  
+  Learn more in the [HTTP snippets documentation](/docs/api-references/http-snippets).
 </ParamField>
 
 <ParamField path="settings.hide-404-page" type="boolean" required={false} default="false" toc={true}>