diff --git a/fern/snippets/openapi-specs.mdx b/fern/snippets/openapi-specs.mdx
index 7c364addb..cf0c84310 100644
--- a/fern/snippets/openapi-specs.mdx
+++ b/fern/snippets/openapi-specs.mdx
@@ -117,3 +117,25 @@ api:
   Disabled by default to maintain backwards compatibility.
 
 </ParamField>
+
+<ParamField path="resolve-aliases" type="boolean" default="false" toc={true}>
+  Inlines type aliases to simplify your generated SDK. When enabled, reduces
+  unnecessary type definitions by replacing simple aliases with their underlying
+  types directly. Useful for OpenAPI specs with many primitive or simple type
+  aliases.
+
+  Set to `true` to inline all aliases, or use an object with an `except` array
+  to preserve specific type aliases:
+
+  ```yaml
+  settings:
+    # Inline all aliases
+    resolve-aliases: true
+
+    # Or preserve specific aliases
+    resolve-aliases:
+      except:
+        - UserId
+        - OrganizationId
+  ```
+</ParamField>