diff --git a/installation.mdx b/installation.mdx
index 68eca503e..a1e887351 100644
--- a/installation.mdx
+++ b/installation.mdx
@@ -334,11 +334,7 @@ mint scrape openapi <openApiFilename or URL>
 
 ### Upgrade configuration
 
-Convert a `mint.json` configuration file to the current `docs.json` format:
-
-```bash
-mint upgrade
-```
+The CLI automatically converts a `mint.json` configuration file to `docs.json` when you run `mint dev`, `mint broken-links`, or `mint rename`. No manual step is required.
 
 See [Global settings](/organize/settings) for more information about `docs.json`.
 
diff --git a/organize/settings.mdx b/organize/settings.mdx
index 1a7e84e15..8713d691b 100644
--- a/organize/settings.mdx
+++ b/organize/settings.mdx
@@ -145,13 +145,9 @@ If your project uses the deprecated `mint.json` file, follow these steps to upgr
     ```
   </Step>
   <Step title="Create your docs.json file">
-    In your docs repository, run:
+    Run any CLI command such as `mint dev` in your docs repository. The CLI automatically detects `mint.json` and converts it to `docs.json`.
 
-    ```bash
-    mint upgrade
-    ```
-
-    This command creates a `docs.json` file from your existing `mint.json`. Review the generated file to ensure all settings are correct.
+    Review the generated file to ensure all settings are correct.
   </Step>
   <Step title="Delete your mint.json file">
     After verifying your `docs.json` is configured correctly, you can safely delete your old `mint.json` file.