diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx
index d6529d649..527580e9e 100644
--- a/fern/products/cli-api-reference/pages/commands.mdx
+++ b/fern/products/cli-api-reference/pages/commands.mdx
@@ -498,9 +498,13 @@ hideOnThisPage: true
   <Accordion title="fern generator upgrade">
     Use `fern generator upgrade` to update all generators in your `generators.yml` to their latest versions.
 
+    <Note>
+    This is different from `fern upgrade` which updates the Fern CLI version. Use both commands to keep your entire Fern toolchain up to date.
+    </Note>
+
     <CodeBlock title="terminal">
     ```bash
-    fern generator upgrade [--list] [--generator <generator-name>] [--group <group>]
+    fern generator upgrade [--list] [--generator <generator-name>] [--group <group>] [--include-major]
     ```
     </CodeBlock>
 
@@ -553,8 +557,13 @@ hideOnThisPage: true
     fern generator upgrade --group public
     ```
 
-    <Note>
-    This is different from `fern upgrade` which updates the Fern CLI version. Use both commands to keep your entire Fern toolchain up to date.
-    </Note>
+    ### include-major
+
+    ```bash
+    fern generator upgrade --include-major
+    ```
+
+     Use `--include-major` to include major version upgrades. Major versions are skipped by default to prevent breaking changes.
+  
   </Accordion>
 </AccordionGroup>