diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx
index d7dd0d5486..e371841bc4 100644
--- a/api-playground/openapi-setup.mdx
+++ b/api-playground/openapi-setup.mdx
@@ -151,7 +151,6 @@ The `x-default` extension supports `apiKey` and `http` bearer security scheme ty
 
 Use `x-default` on other schema properties in your OpenAPI specification to set a default value in the API playground without affecting the `default` field in the schema definition. Unlike security schemes, prefill for non-security-scheme properties only takes effect when you set [`api.examples.prefill`](/organize/settings-api) to `true` in your [`docs.json`](/api-playground/overview#example-configuration).
 
-
 ## Let visitors download your spec
 
 Opt into a "Download API spec" entry in the [page context menu](/organize/settings-structure#contextual) by adding `"download-spec"` to `contextual.options` in your `docs.json`:
diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx
index 90d041a102..e5ac6f9418 100644
--- a/api-playground/troubleshooting.mdx
+++ b/api-playground/troubleshooting.mdx
@@ -106,6 +106,25 @@ If your API pages aren't displaying correctly, check these common configuration
     2. **Invalid operations**: Operations with validation errors in the OpenAPI spec may be skipped. Check your OpenAPI document for syntax errors.
     3. **Manual vs automatic inclusion**: If you reference any endpoints from an OpenAPI spec, only the explicitly referenced operations appear in navigation. No other pages are automatically added. This includes operations that are referenced in child navigation elements.
   </Accordion>
+  <Accordion title="The Authorization field description is generic or unhelpful">
+    Mintlify auto-generates a description for the `Authorization` field in the API playground based on the security scheme type. Override it by adding a `description` to the security scheme in your OpenAPI specification.
+
+    ```json {7}
+    {
+      "components": {
+        "securitySchemes": {
+          "bearerAuth": {
+            "type": "http",
+            "scheme": "bearer",
+            "description": "Your API key from the [dashboard](https://example.com/dashboard). Send it as `Bearer <key>`."
+          }
+        }
+      }
+    }
+    ```
+
+    The `description` supports Markdown and replaces the auto-generated text on every endpoint that uses the security scheme.
+  </Accordion>
   <Accordion title="Mixed navigation (OpenAPI and MDX pages) not working correctly">
     When combining OpenAPI operations with regular documentation pages in navigation: