From 97a990f0cac8916d3d6f0d247878509bdbce1405 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 10 Mar 2026 02:55:14 +0000
Subject: [PATCH] Document upgrade, scrape, and version CLI commands

Generated-By: mintlify-agent
---
 installation.mdx | 52 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/installation.mdx b/installation.mdx
index 333d18e35..4772c7e7d 100644
--- a/installation.mdx
+++ b/installation.mdx
@@ -250,6 +250,58 @@ mint migrate-mdx
 
 This command converts individual MDX endpoint pages to autogenerated pages defined in your `docs.json`, moves MDX content to the `x-mint` extension in your OpenAPI specification, and updates your navigation. See [Migrating from MDX](/guides/migrating-from-mdx) for detailed information.
 
+### Upgrade configuration
+
+If you have an existing `mint.json` configuration file, upgrade it to the current `docs.json` format:
+
+```bash
+mint upgrade
+```
+
+This command converts your `mint.json` to `docs.json` with the new configuration structure. For more details, see [Global settings](/organize/settings).
+
+### Scrape documentation
+
+Import content from external documentation sites using the scrape commands. These commands are useful for migrating existing documentation to Mintlify.
+
+**Scrape an entire documentation site:**
+
+```bash
+mint scrape site <url>
+```
+
+| Option | Description |
+| --- | --- |
+| `--filter`, `-f` | Only scrape URLs matching this path filter (for example, `/docs` matches `/docs` and `/docs/*`). |
+
+**Scrape a single documentation page:**
+
+```bash
+mint scrape page <url>
+```
+
+**Generate MDX files from an OpenAPI spec:**
+
+```bash
+mint scrape openapi <filename-or-url>
+```
+
+| Option | Description | Default |
+| --- | --- | --- |
+| `--writeFiles`, `-w` | Write the generated frontmatter files to disk. | `true` |
+| `--outDir`, `-o` | The folder to write generated files. | Current directory |
+| `--overwrite` | Overwrite existing files. | `false` |
+
+For more information, see [Migration](/migration).
+
+### Show CLI version
+
+Display the current version of the CLI and client:
+
+```bash
+mint version
+```
+
 ## Formatting
 
 While developing locally, we recommend using extensions in your IDE to recognize and format MDX files.