diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 6267bcdd7d..100211aa0f 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -29,7 +29,18 @@ In the project's **package.json** file, identify all SPFx vTODO: {version-previo
     npm install @microsoft/{spfx-package-name}@TODO: {version-release}.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion TODO: {version-release} --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 35ce53bcb8..de5e3fb852 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx pre-v1 packages. For e
     npm install @microsoft/{spfx-package-name}@1.0.0.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.0.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.1.0.md b/docs/spfx/release-1.1.0.md
index 017e3aa7d7..4704f722cf 100644
--- a/docs/spfx/release-1.1.0.md
+++ b/docs/spfx/release-1.1.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.0 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.1.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index d3b939845c..4693614659 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.9.1 packages. For e
     npm install @microsoft/{spfx-package-name}@1.10.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.10.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 974050813b..720d007875 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -33,7 +33,18 @@ In the project's **package.json** file, identify all SPFx v1.10 packages. For ea
 > [!IMPORTANT]
 > Be sure you update the **package-solution.json** with the new developers information as described in the article [Docs: SharePoint Framework toolchain - Update developer information](toolchain/sharepoint-framework-toolchain.md). Not providing such information will generate an error during gulp package-solution process.
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.11.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 3f4bf14fac..68f2aa8d75 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.11.0 packages. For
     npm install @microsoft/{spfx-package-name}@1.12.1 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.12.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.13.0.md b/docs/spfx/release-1.13.0.md
index a577af60ac..5a001b3c5a 100644
--- a/docs/spfx/release-1.13.0.md
+++ b/docs/spfx/release-1.13.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.12.1 packages. For
     npm install @microsoft/{spfx-package-name}@1.13.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.13 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index edf26d9883..53e51bc48c 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.13 packages. For ea
     npm install @microsoft/{spfx-package-name}@1.13.1 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.13.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Changes in this release
 
diff --git a/docs/spfx/release-1.14.0.md b/docs/spfx/release-1.14.0.md
index 293517b638..cac9f87db0 100644
--- a/docs/spfx/release-1.14.0.md
+++ b/docs/spfx/release-1.14.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.13.1 packages. For
     npm install @microsoft/{spfx-package-name}@1.14.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.14 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.15.0.md b/docs/spfx/release-1.15.0.md
index 9641ee0e84..01b56a2281 100644
--- a/docs/spfx/release-1.15.0.md
+++ b/docs/spfx/release-1.15.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.14 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.15 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index ea755382a7..532eb24da2 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.15.0 packages. For
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.15.2 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
@@ -50,7 +61,7 @@ Now developers are able to specify **optional** attributes `appId` and `replyUrl
 
 When these attributes are present, administrators are presented standard Azure AD app registration consent as part of the API approval process.
 
-For more information on this feature, see: [Requesting permissions to Azure AD applications in another tenant](use-aadhttpclient.md#requesting-permissions-to-azure-ad-applications-in-another-tenant).
+For more information on this feature, see: [Requesting permissions to Entra ID applications in another tenant](use-aadhttpclient.md#requesting-permissions-to-entra-id-applications-in-another-tenant).
 
 ### New Action types for media - General Availability
 
diff --git a/docs/spfx/release-1.16.0.md b/docs/spfx/release-1.16.0.md
index 99eb1bb61c..33fd1cc594 100644
--- a/docs/spfx/release-1.16.0.md
+++ b/docs/spfx/release-1.16.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.15.2 packages. For
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.16 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index 1d9d6f100a..f6da25ad9c 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.16 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.16.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.17.0.md b/docs/spfx/release-1.17.0.md
index bc3bd02c01..f53770f53a 100644
--- a/docs/spfx/release-1.17.0.md
+++ b/docs/spfx/release-1.17.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.16.1 packages. For
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.17 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index b1c0adb54b..e98731a0a3 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -39,7 +39,18 @@ In the project's **package.json** file, identify all SPFx v1.17 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.17.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index a556ec9b4e..65f4782637 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -40,7 +40,18 @@ npm install @microsoft/generator-sharepoint@latest --global
         npm install @microsoft/{spfx-package-name}@latest --save --save-exact
         ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.17.2 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 2f2ea1726d..1e789f562b 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -40,7 +40,18 @@ npm install @microsoft/generator-sharepoint@latest --global
         npm install @microsoft/{spfx-package-name}@latest --save --save-exact
         ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.17.3 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index d7e89e2187..d1393bfab1 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -40,7 +40,18 @@ npm install @microsoft/generator-sharepoint@latest --global
         npm install @microsoft/{spfx-package-name}@latest --save --save-exact
         ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.17.4 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.18.0.md b/docs/spfx/release-1.18.0.md
index 0dd5414583..5a0f0a4ce7 100644
--- a/docs/spfx/release-1.18.0.md
+++ b/docs/spfx/release-1.18.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.17.x packages. For
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.18 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index ac3110852c..52f2f88d43 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
     npm install @microsoft/{spfx-package-name}@1.18.1 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.18.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index be708a1224..e838b0e674 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.18.2 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.19.0.md b/docs/spfx/release-1.19.0.md
index 81f207b11f..4b8747573e 100644
--- a/docs/spfx/release-1.19.0.md
+++ b/docs/spfx/release-1.19.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.18.x packages. For
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.19 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.20.0.md b/docs/spfx/release-1.20.0.md
index d688f4995e..80ad7f67e8 100644
--- a/docs/spfx/release-1.20.0.md
+++ b/docs/spfx/release-1.20.0.md
@@ -36,7 +36,18 @@ In the project's **package.json** file, identify all SPFx v1.19 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.20 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.21.0.md b/docs/spfx/release-1.21.0.md
index d532ddc470..bb3e2a0546 100644
--- a/docs/spfx/release-1.21.0.md
+++ b/docs/spfx/release-1.21.0.md
@@ -39,7 +39,18 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.21 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index b84662f003..73bce279cc 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -39,7 +39,18 @@ In the project's **package.json** file, identify all SPFx v1.21 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.21.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.22.0.md b/docs/spfx/release-1.22.0.md
index 507c4b4e45..86a1f03fca 100644
--- a/docs/spfx/release-1.22.0.md
+++ b/docs/spfx/release-1.22.0.md
@@ -27,6 +27,19 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 The upgrade steps required to convert a [gulp-based toolchain](toolchain/sharepoint-framework-toolchain.md) SPFx project to the [Heft-based toolchain](toolchain/sharepoint-framework-toolchain-rushstack-heft.md) are detailed in the following article: [Migrate from the Gulp Toolchain to Heft Toolchain](toolchain/migrate-gulptoolchain-hefttoolchain.md).
 
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
+
 ## New features and capabilities
 
 ### Transitioning from Gulp-based toolchain to the Heft-based toolchain
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 1fb1465bf6..07edc55178 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -39,7 +39,18 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 55c7e7fad6..670efb8b82 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -39,7 +39,18 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
     npm install @microsoft/{spfx-package-name}@latest --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.2 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Fixed Issues
 
diff --git a/docs/spfx/release-1.23.0.md b/docs/spfx/release-1.23.0.md
index cf6ac9d0dc..d718d0347f 100644
--- a/docs/spfx/release-1.23.0.md
+++ b/docs/spfx/release-1.23.0.md
@@ -24,6 +24,19 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 If you are upgrading from older than 1.22 version, please follow the upgrade steps required to convert a [gulp-based toolchain](toolchain/sharepoint-framework-toolchain.md) SPFx project to the [Heft-based toolchain](toolchain/sharepoint-framework-toolchain-rushstack-heft.md) are detailed in the following article: [Migrate from the Gulp Toolchain to Heft Toolchain](toolchain/migrate-gulptoolchain-hefttoolchain.md).
 
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.23.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
+
 ## New features and capabilities
 
 ### Grouping support for list view command sets
diff --git a/docs/spfx/release-1.3.0.md b/docs/spfx/release-1.3.0.md
index 18fa1f9f1f..94baee1f73 100644
--- a/docs/spfx/release-1.3.0.md
+++ b/docs/spfx/release-1.3.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.1 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.3.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.3 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.4.0.md b/docs/spfx/release-1.4.0.md
index ce55e6865f..8be13996c2 100644
--- a/docs/spfx/release-1.4.0.md
+++ b/docs/spfx/release-1.4.0.md
@@ -26,7 +26,18 @@ In the project's **package.json** file, identify all SPFx v1.3 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.4.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.4 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index aec7c5cfc4..84488a89ba 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -26,7 +26,18 @@ In the project's **package.json** file, identify all SPFx v1.4 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.4.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.5.0.md b/docs/spfx/release-1.5.0.md
index 49dbeae050..14b9c6767b 100644
--- a/docs/spfx/release-1.5.0.md
+++ b/docs/spfx/release-1.5.0.md
@@ -49,7 +49,18 @@ Key changes are around the introduction of the new *plusbeta* model and many oth
     }
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.5 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index c8349b11f2..15a68b958e 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.5 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.5.1 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.5.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Changes in this release
 
diff --git a/docs/spfx/release-1.6.0.md b/docs/spfx/release-1.6.0.md
index ebec1c9ff5..7884827dc6 100644
--- a/docs/spfx/release-1.6.0.md
+++ b/docs/spfx/release-1.6.0.md
@@ -31,7 +31,18 @@ In the project's **package.json** file, identify all SPFx v1.5.1 packages. For e
     npm install @microsoft/{spfx-package-name}@1.6.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.6 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.7.0.md b/docs/spfx/release-1.7.0.md
index cca1d0c389..2857e2c129 100644
--- a/docs/spfx/release-1.7.0.md
+++ b/docs/spfx/release-1.7.0.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.6 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.7.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.7 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index f2670b3bfe..4e59f27534 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.7 packages. For eac
     npm install @microsoft/{spfx-package-name}@1.7.1.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.7.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Changes in this release
 
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 41aecf5185..3fb1c4c980 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -51,7 +51,18 @@ We'll release more updated documentation and guidance videos during upcoming day
 
 1. Fix all the new and interesting tslint errors that are now getting raised with a newer compiler. For large projects, this might take a while. The default behavior of the TypeScript compilers is getting stricter, but your code will be the better for it.
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.8.0 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 904c3f6097..65fba6273c 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.8.0 packages. For e
     npm install @microsoft/{spfx-package-name}@1.8.1.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.8.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Changes in this release
 
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 44ebf114b7..84877e723d 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.8.1 packages. For e
     npm install @microsoft/{spfx-package-name}@1.8.2.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.8.2 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## Changes in this release
 
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index d759074ec6..312bb397aa 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -28,7 +28,18 @@ In the project's **package.json** file, identify all SPFx v1.8.2 packages. For e
     npm install @microsoft/{spfx-package-name}@1.9.1.0 --save --save-exact
     ```
 
-[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
+[!INCLUDE [spfx-release-upgrade-warning](../../includes/snippets/spfx-release-upgrade-warning.md)]
+
+> [!TIP]
+> To upgrade this project, run:
+>
+> ```console
+> npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.9.1 --output md
+> ```
+>
+> This analyzes your project and outputs the exact file changes, package updates, and configuration steps to apply, regardless of your current SPFx version.
+
+[!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
 ## New features and capabilities
 
diff --git a/includes/snippets/spfx-release-upgrade-tip.md b/includes/snippets/spfx-release-upgrade-tip.md
deleted file mode 100644
index b8da86cbf1..0000000000
--- a/includes/snippets/spfx-release-upgrade-tip.md
+++ /dev/null
@@ -1,3 +0,0 @@
-
-> [!TIP]
-> The [CLI for Microsoft 365](https://aka.ms/o365cli) provides an easy step-by-step guidance to [upgrade](https://pnp.github.io/cli-microsoft365/cmd/spfx/project/project-upgrade/) your solutions to latest SharePoint Framework version.
diff --git a/includes/snippets/spfx-release-upgrade-warning.md b/includes/snippets/spfx-release-upgrade-warning.md
new file mode 100644
index 0000000000..40f6ea475b
--- /dev/null
+++ b/includes/snippets/spfx-release-upgrade-warning.md
@@ -0,0 +1,3 @@
+
+> [!WARNING]
+> Upgrading from a previous minor version requires changes across package versions, build configuration files, and toolchain settings that vary depending on your source version. Manually updating package.json alone will result in build failures.