From db6b05dec5b0e2ac32c674d29ba7808544f5fb25 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 1 Apr 2026 19:16:06 +0000
Subject: [PATCH] Update docs: mint upgrade replaced by automatic upgrade

Generated-By: mintlify-agent
---
 installation.mdx      | 6 +-----
 organize/settings.mdx | 8 ++------
 2 files changed, 3 insertions(+), 11 deletions(-)

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.