From 56f46123b41f4c5ce203674006b94c8dcc506e06 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:28:24 +0100
Subject: [PATCH 01/11] Replace CLI upgrade TIP with WARNING in SPFx release
 notes

Replace the TIP recommending CLI for Microsoft 365 for upgrades with a
WARNING explaining that upgrading from a previous minor version requires
changes across package versions, build configuration files, and toolchain
settings.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 includes/snippets/spfx-release-upgrade-tip.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/includes/snippets/spfx-release-upgrade-tip.md b/includes/snippets/spfx-release-upgrade-tip.md
index b8da86cbf1..40f6ea475b 100644
--- a/includes/snippets/spfx-release-upgrade-tip.md
+++ b/includes/snippets/spfx-release-upgrade-tip.md
@@ -1,3 +1,3 @@
 
-> [!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.
+> [!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.

From a97c8e8e845fbae71e3581e8a52afbbef83ffdc3 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:41:59 +0100
Subject: [PATCH 02/11] Add version-specific upgrade TIP to each SPFx release
 page

Add a TIP after the WARNING on each release page showing the exact
npx command to run for upgrading to that specific version using
CLI for Microsoft 365's spfx project upgrade command.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template | 9 +++++++++
 docs/spfx/release-1.0.0.md          | 9 +++++++++
 docs/spfx/release-1.1.md            | 9 +++++++++
 docs/spfx/release-1.10.0.md         | 9 +++++++++
 docs/spfx/release-1.11.0.md         | 9 +++++++++
 docs/spfx/release-1.12.1.md         | 9 +++++++++
 docs/spfx/release-1.13.1.md         | 9 +++++++++
 docs/spfx/release-1.13.md           | 9 +++++++++
 docs/spfx/release-1.14.md           | 9 +++++++++
 docs/spfx/release-1.15.2.md         | 9 +++++++++
 docs/spfx/release-1.15.md           | 9 +++++++++
 docs/spfx/release-1.16.1.md         | 9 +++++++++
 docs/spfx/release-1.16.md           | 9 +++++++++
 docs/spfx/release-1.17.1.md         | 9 +++++++++
 docs/spfx/release-1.17.2.md         | 9 +++++++++
 docs/spfx/release-1.17.3.md         | 9 +++++++++
 docs/spfx/release-1.17.4.md         | 9 +++++++++
 docs/spfx/release-1.17.md           | 9 +++++++++
 docs/spfx/release-1.18.1.md         | 9 +++++++++
 docs/spfx/release-1.18.2.md         | 9 +++++++++
 docs/spfx/release-1.18.md           | 9 +++++++++
 docs/spfx/release-1.19.md           | 9 +++++++++
 docs/spfx/release-1.20.md           | 9 +++++++++
 docs/spfx/release-1.21.1.md         | 9 +++++++++
 docs/spfx/release-1.21.md           | 9 +++++++++
 docs/spfx/release-1.22.1.md         | 9 +++++++++
 docs/spfx/release-1.22.2.md         | 9 +++++++++
 docs/spfx/release-1.3.md            | 9 +++++++++
 docs/spfx/release-1.4.1.md          | 9 +++++++++
 docs/spfx/release-1.4.md            | 9 +++++++++
 docs/spfx/release-1.5.1.md          | 9 +++++++++
 docs/spfx/release-1.5.md            | 9 +++++++++
 docs/spfx/release-1.6.md            | 9 +++++++++
 docs/spfx/release-1.7.1.md          | 9 +++++++++
 docs/spfx/release-1.7.md            | 9 +++++++++
 docs/spfx/release-1.8.0.md          | 9 +++++++++
 docs/spfx/release-1.8.1.md          | 9 +++++++++
 docs/spfx/release-1.8.2.md          | 9 +++++++++
 docs/spfx/release-1.9.1.md          | 9 +++++++++
 39 files changed, 351 insertions(+)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 6267bcdd7d..778b44d1fc 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -31,6 +31,15 @@ In the project's **package.json** file, identify all SPFx vTODO: {version-previo
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 TODO:
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 35ce53bcb8..0ebd21ce0d 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx pre-v1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 You can get the updated npm packages and use them in the local workbench, and everything should be fine. However, the rollout of the code to the servers will be done in stages over the course of several days. By sometime next week 100% of the farms should have it. We do this to monitor the rollout and make sure we don't have any issues.
diff --git a/docs/spfx/release-1.1.md b/docs/spfx/release-1.1.md
index d731656a19..3a40a0ca39 100644
--- a/docs/spfx/release-1.1.md
+++ b/docs/spfx/release-1.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.0 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SPFx Extensions (developer preview)
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index d3b939845c..770903d4fa 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.9.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Create Search Extensions (dev preview)
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 974050813b..0b8e14f8db 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -35,6 +35,15 @@ In the project's **package.json** file, identify all SPFx v1.10 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Supporting SharePoint Framework solutions in AppSource and in Marketplace
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 3f4bf14fac..065f85f7f5 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.11.0 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - The **Sync to Teams** button in the Tenant App Catalog will use the Teams app manifest defined in the solution if present to create and publish a Teams app package to Microsoft Teams. If an app manifest file is not present, SharePoint will dynamically generate one.
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index edf26d9883..16719da341 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.13 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - 1.13.0 for "Create a subfolder with solution name" does not work
diff --git a/docs/spfx/release-1.13.md b/docs/spfx/release-1.13.md
index de1bbccfef..0d1acf06cb 100644
--- a/docs/spfx/release-1.13.md
+++ b/docs/spfx/release-1.13.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.12.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - The new feature of this release is the extensibility model for the upcoming Viva Connections feature. The beta will allow you to create Adaptive Card Extensions (ACEs) and test them in the hosted workbench.
diff --git a/docs/spfx/release-1.14.md b/docs/spfx/release-1.14.md
index 3c58245578..ec979e508b 100644
--- a/docs/spfx/release-1.14.md
+++ b/docs/spfx/release-1.14.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.13.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Adaptive Card Extension updates for Viva Connections
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index ea755382a7..65774453a9 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.15.0 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Enable Service Principal Registration at Permission Scope Approval Time
diff --git a/docs/spfx/release-1.15.md b/docs/spfx/release-1.15.md
index d739f92e3f..9d4eb8eed1 100644
--- a/docs/spfx/release-1.15.md
+++ b/docs/spfx/release-1.15.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.14 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Form Customizer Extension
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index be89e83e10..dab176846a 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.16 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Promoting `config/sass.json` file
diff --git a/docs/spfx/release-1.16.md b/docs/spfx/release-1.16.md
index 5c7b13d31e..17c28380e1 100644
--- a/docs/spfx/release-1.16.md
+++ b/docs/spfx/release-1.16.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.15.2 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Publish Teams solutions build with SPFx to Outlook and Office
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index 20f25b9407..1f292fa5a8 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.17 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index 490670fbdc..c0f2974354 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 2f2ea1726d..17a3f88193 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index d7e89e2187..f440e7ae49 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Enable Strict Null Check for the generated solutions
diff --git a/docs/spfx/release-1.17.md b/docs/spfx/release-1.17.md
index 5c711be98d..9164f989ba 100644
--- a/docs/spfx/release-1.17.md
+++ b/docs/spfx/release-1.17.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.16.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Updates and improvements on building Microsoft 365 wide experiences with **Microsoft Teams apps build with SharePoint Framework** – This model enables you to build auto-hosted apps in Microsoft 365, which are extended across Microsoft Teams, Outlook and Office 365 app (office.com). Any Microsoft Teams app build with SharePoint Framework is automatically now compliant with the requirements to get the app exposed across Microsoft 365.
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index ac3110852c..740e360bec 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Partial Support for Teams JS SDK in Adaptive Card Extensions (Mobile only)
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index be708a1224..3eb40a3c87 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Adding support of Yeoman generator v5.x
diff --git a/docs/spfx/release-1.18.md b/docs/spfx/release-1.18.md
index 8163ad45f1..eaf92b48f2 100644
--- a/docs/spfx/release-1.18.md
+++ b/docs/spfx/release-1.18.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.17.x packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 Related updated documentation for the 1.18 release:
diff --git a/docs/spfx/release-1.19.md b/docs/spfx/release-1.19.md
index 456aa35d2c..c910849347 100644
--- a/docs/spfx/release-1.19.md
+++ b/docs/spfx/release-1.19.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.18.x packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### New Data Visualization Card Template for Adaptive Card Extensions
diff --git a/docs/spfx/release-1.20.md b/docs/spfx/release-1.20.md
index f55d341274..28a86ad229 100644
--- a/docs/spfx/release-1.20.md
+++ b/docs/spfx/release-1.20.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.19 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### New Data Visualization Card options for Viva Connections
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index 05b54b2d40..96434adac4 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.21 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.21.md b/docs/spfx/release-1.21.md
index 4790f2ba7a..c97dd49f20 100644
--- a/docs/spfx/release-1.21.md
+++ b/docs/spfx/release-1.21.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Node.js v22 support
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 1fb1465bf6..6e0befe0f8 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 55c7e7fad6..2f4f016586 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Starting January 2026, we are introducing a monthly minor release cycle focused on keeping the SharePoint Framework developer environment clean from known npm vulnerabilities. The goal is to avoid confusion when npm audit reports issues during solution scaffolding on local development machines.
diff --git a/docs/spfx/release-1.3.md b/docs/spfx/release-1.3.md
index 5d24d95fdf..ce35266157 100644
--- a/docs/spfx/release-1.3.md
+++ b/docs/spfx/release-1.3.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.1 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SharePoint Extensions (general availability)
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index aec7c5cfc4..d5e2553ad6 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -28,6 +28,15 @@ In the project's **package.json** file, identify all SPFx v1.4 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Node v8 (LTS) and NPM v5 Support
diff --git a/docs/spfx/release-1.4.md b/docs/spfx/release-1.4.md
index 519f4df2a6..261adee5a8 100644
--- a/docs/spfx/release-1.4.md
+++ b/docs/spfx/release-1.4.md
@@ -28,6 +28,15 @@ In the project's **package.json** file, identify all SPFx v1.3 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### @microsoft/sp-tslint-rules
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index c8349b11f2..3519d52a57 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.5 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Fixed the issue in the yeoman generator that blocked you from creating different types of components in your package.
diff --git a/docs/spfx/release-1.5.md b/docs/spfx/release-1.5.md
index c6908cb237..31a95318ea 100644
--- a/docs/spfx/release-1.5.md
+++ b/docs/spfx/release-1.5.md
@@ -51,6 +51,15 @@ 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)]
 
+> [!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.
+
 ## New features and capabilities
 
 ### Ship vs. Beta APIs are now separate packages
diff --git a/docs/spfx/release-1.6.md b/docs/spfx/release-1.6.md
index bc3450473d..0e69419ab2 100644
--- a/docs/spfx/release-1.6.md
+++ b/docs/spfx/release-1.6.md
@@ -33,6 +33,15 @@ In the project's **package.json** file, identify all SPFx v1.5.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Web API (general availability)
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index f2670b3bfe..add7a8688f 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.7 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Update title of user data property title in dynamic data
diff --git a/docs/spfx/release-1.7.md b/docs/spfx/release-1.7.md
index 9441b98e94..d416b04e48 100644
--- a/docs/spfx/release-1.7.md
+++ b/docs/spfx/release-1.7.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.6 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Dynamic Data
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 41aecf5185..06f025020d 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -53,6 +53,15 @@ We'll release more updated documentation and guidance videos during upcoming day
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SPFx development for Teams tabs (General Availability)
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 904c3f6097..8f7e736bbf 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.0 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Fixed: Not able to set up SharePoint Server 2016 or SharePoint Server 2019 on premises using **\@microsoft/sharepoint** Yeoman generator  (two issues mentioned – incorrect SupportedHosts property and incorrect reference to sp-property-pane)
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 44ebf114b7..20fb0af670 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Released the `context.microsoftTeams` property to generally available (GA).
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index d759074ec6..1aede9e228 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.2 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - **Library Components (GA)**

From 90e3802ba785fe4694eefe561312d4f0257535a3 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:44:52 +0100
Subject: [PATCH 03/11] Rename snippet from spfx-release-upgrade-tip to
 spfx-release-upgrade-warning

The snippet now contains a WARNING, so the filename should reflect that.
Updated all references across release pages and the template.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template                             | 2 +-
 docs/spfx/release-1.0.0.md                                      | 2 +-
 docs/spfx/release-1.1.md                                        | 2 +-
 docs/spfx/release-1.10.0.md                                     | 2 +-
 docs/spfx/release-1.11.0.md                                     | 2 +-
 docs/spfx/release-1.12.1.md                                     | 2 +-
 docs/spfx/release-1.13.1.md                                     | 2 +-
 docs/spfx/release-1.13.md                                       | 2 +-
 docs/spfx/release-1.14.md                                       | 2 +-
 docs/spfx/release-1.15.2.md                                     | 2 +-
 docs/spfx/release-1.15.md                                       | 2 +-
 docs/spfx/release-1.16.1.md                                     | 2 +-
 docs/spfx/release-1.16.md                                       | 2 +-
 docs/spfx/release-1.17.1.md                                     | 2 +-
 docs/spfx/release-1.17.2.md                                     | 2 +-
 docs/spfx/release-1.17.3.md                                     | 2 +-
 docs/spfx/release-1.17.4.md                                     | 2 +-
 docs/spfx/release-1.17.md                                       | 2 +-
 docs/spfx/release-1.18.1.md                                     | 2 +-
 docs/spfx/release-1.18.2.md                                     | 2 +-
 docs/spfx/release-1.18.md                                       | 2 +-
 docs/spfx/release-1.19.md                                       | 2 +-
 docs/spfx/release-1.20.md                                       | 2 +-
 docs/spfx/release-1.21.1.md                                     | 2 +-
 docs/spfx/release-1.21.md                                       | 2 +-
 docs/spfx/release-1.22.1.md                                     | 2 +-
 docs/spfx/release-1.22.2.md                                     | 2 +-
 docs/spfx/release-1.3.md                                        | 2 +-
 docs/spfx/release-1.4.1.md                                      | 2 +-
 docs/spfx/release-1.4.md                                        | 2 +-
 docs/spfx/release-1.5.1.md                                      | 2 +-
 docs/spfx/release-1.5.md                                        | 2 +-
 docs/spfx/release-1.6.md                                        | 2 +-
 docs/spfx/release-1.7.1.md                                      | 2 +-
 docs/spfx/release-1.7.md                                        | 2 +-
 docs/spfx/release-1.8.0.md                                      | 2 +-
 docs/spfx/release-1.8.1.md                                      | 2 +-
 docs/spfx/release-1.8.2.md                                      | 2 +-
 docs/spfx/release-1.9.1.md                                      | 2 +-
 ...x-release-upgrade-tip.md => spfx-release-upgrade-warning.md} | 0
 40 files changed, 39 insertions(+), 39 deletions(-)
 rename includes/snippets/{spfx-release-upgrade-tip.md => spfx-release-upgrade-warning.md} (100%)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 778b44d1fc..5196dbd501 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -29,7 +29,7 @@ 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:
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 0ebd21ce0d..3e348e15d8 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.1.md b/docs/spfx/release-1.1.md
index 3a40a0ca39..91b89652bb 100644
--- a/docs/spfx/release-1.1.md
+++ b/docs/spfx/release-1.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index 770903d4fa..7f1f426a05 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 0b8e14f8db..391e32659c 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -33,7 +33,7 @@ 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:
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 065f85f7f5..e097456347 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index 16719da341..397ef11baf 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.13.md b/docs/spfx/release-1.13.md
index 0d1acf06cb..dd99c909fe 100644
--- a/docs/spfx/release-1.13.md
+++ b/docs/spfx/release-1.13.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.14.md b/docs/spfx/release-1.14.md
index ec979e508b..594672ab17 100644
--- a/docs/spfx/release-1.14.md
+++ b/docs/spfx/release-1.14.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index 65774453a9..647484ecda 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.15.md b/docs/spfx/release-1.15.md
index 9d4eb8eed1..3e0d3eed32 100644
--- a/docs/spfx/release-1.15.md
+++ b/docs/spfx/release-1.15.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index dab176846a..afcd98048f 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.16.md b/docs/spfx/release-1.16.md
index 17c28380e1..fcd08d9b8f 100644
--- a/docs/spfx/release-1.16.md
+++ b/docs/spfx/release-1.16.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index 1f292fa5a8..4fb3463112 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index c0f2974354..0dddabf2fe 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 17a3f88193..72768ca511 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index f440e7ae49..13833ebd4e 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.17.md b/docs/spfx/release-1.17.md
index 9164f989ba..2f48072042 100644
--- a/docs/spfx/release-1.17.md
+++ b/docs/spfx/release-1.17.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index 740e360bec..a52144e81e 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index 3eb40a3c87..d3baa1291f 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.18.md b/docs/spfx/release-1.18.md
index eaf92b48f2..11af9dc039 100644
--- a/docs/spfx/release-1.18.md
+++ b/docs/spfx/release-1.18.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.19.md b/docs/spfx/release-1.19.md
index c910849347..dfb35f3a48 100644
--- a/docs/spfx/release-1.19.md
+++ b/docs/spfx/release-1.19.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.20.md b/docs/spfx/release-1.20.md
index 28a86ad229..74b9b642e4 100644
--- a/docs/spfx/release-1.20.md
+++ b/docs/spfx/release-1.20.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index 96434adac4..99c39002b6 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.21.md b/docs/spfx/release-1.21.md
index c97dd49f20..5a423d5183 100644
--- a/docs/spfx/release-1.21.md
+++ b/docs/spfx/release-1.21.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 6e0befe0f8..944e613674 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 2f4f016586..09ffbe3a87 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.3.md b/docs/spfx/release-1.3.md
index ce35266157..82f933fccd 100644
--- a/docs/spfx/release-1.3.md
+++ b/docs/spfx/release-1.3.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index d5e2553ad6..1393331ed5 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -26,7 +26,7 @@ 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:
diff --git a/docs/spfx/release-1.4.md b/docs/spfx/release-1.4.md
index 261adee5a8..8ea4348ee6 100644
--- a/docs/spfx/release-1.4.md
+++ b/docs/spfx/release-1.4.md
@@ -26,7 +26,7 @@ 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:
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index 3519d52a57..0fdf5eb253 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.5.md b/docs/spfx/release-1.5.md
index 31a95318ea..6bf12d575e 100644
--- a/docs/spfx/release-1.5.md
+++ b/docs/spfx/release-1.5.md
@@ -49,7 +49,7 @@ 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:
diff --git a/docs/spfx/release-1.6.md b/docs/spfx/release-1.6.md
index 0e69419ab2..7ef8324804 100644
--- a/docs/spfx/release-1.6.md
+++ b/docs/spfx/release-1.6.md
@@ -31,7 +31,7 @@ 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:
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index add7a8688f..e3dbd1f0dc 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.7.md b/docs/spfx/release-1.7.md
index d416b04e48..ba54f83463 100644
--- a/docs/spfx/release-1.7.md
+++ b/docs/spfx/release-1.7.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 06f025020d..8c9db70032 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -51,7 +51,7 @@ 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:
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 8f7e736bbf..98dcea764a 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 20fb0af670..7dfa737d4d 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index 1aede9e228..2fc0716a66 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/includes/snippets/spfx-release-upgrade-tip.md b/includes/snippets/spfx-release-upgrade-warning.md
similarity index 100%
rename from includes/snippets/spfx-release-upgrade-tip.md
rename to includes/snippets/spfx-release-upgrade-warning.md

From 8387e5b2b422ee4fbf1d25e3c4b70936c28b82c1 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:28:24 +0100
Subject: [PATCH 04/11] Replace CLI upgrade TIP with WARNING in SPFx release
 notes

Replace the TIP recommending CLI for Microsoft 365 for upgrades with a
WARNING explaining that upgrading from a previous minor version requires
changes across package versions, build configuration files, and toolchain
settings.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 includes/snippets/spfx-release-upgrade-tip.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/includes/snippets/spfx-release-upgrade-tip.md b/includes/snippets/spfx-release-upgrade-tip.md
index b8da86cbf1..40f6ea475b 100644
--- a/includes/snippets/spfx-release-upgrade-tip.md
+++ b/includes/snippets/spfx-release-upgrade-tip.md
@@ -1,3 +1,3 @@
 
-> [!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.
+> [!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.

From 15dafc3d273b43911602e5bd5a8dcf177d630192 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:41:59 +0100
Subject: [PATCH 05/11] Add version-specific upgrade TIP to each SPFx release
 page

Add a TIP after the WARNING on each release page showing the exact
npx command to run for upgrading to that specific version using
CLI for Microsoft 365's spfx project upgrade command.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template | 9 +++++++++
 docs/spfx/release-1.0.0.md          | 9 +++++++++
 docs/spfx/release-1.1.0.md          | 9 +++++++++
 docs/spfx/release-1.10.0.md         | 9 +++++++++
 docs/spfx/release-1.11.0.md         | 9 +++++++++
 docs/spfx/release-1.12.1.md         | 9 +++++++++
 docs/spfx/release-1.13.0.md         | 9 +++++++++
 docs/spfx/release-1.13.1.md         | 9 +++++++++
 docs/spfx/release-1.14.0.md         | 9 +++++++++
 docs/spfx/release-1.15.0.md         | 9 +++++++++
 docs/spfx/release-1.15.2.md         | 9 +++++++++
 docs/spfx/release-1.16.0.md         | 9 +++++++++
 docs/spfx/release-1.16.1.md         | 9 +++++++++
 docs/spfx/release-1.17.0.md         | 9 +++++++++
 docs/spfx/release-1.17.1.md         | 9 +++++++++
 docs/spfx/release-1.17.2.md         | 9 +++++++++
 docs/spfx/release-1.17.3.md         | 9 +++++++++
 docs/spfx/release-1.17.4.md         | 9 +++++++++
 docs/spfx/release-1.18.0.md         | 9 +++++++++
 docs/spfx/release-1.18.1.md         | 9 +++++++++
 docs/spfx/release-1.18.2.md         | 9 +++++++++
 docs/spfx/release-1.19.0.md         | 9 +++++++++
 docs/spfx/release-1.20.0.md         | 9 +++++++++
 docs/spfx/release-1.21.0.md         | 9 +++++++++
 docs/spfx/release-1.21.1.md         | 9 +++++++++
 docs/spfx/release-1.22.1.md         | 9 +++++++++
 docs/spfx/release-1.22.2.md         | 9 +++++++++
 docs/spfx/release-1.3.0.md          | 9 +++++++++
 docs/spfx/release-1.4.0.md          | 9 +++++++++
 docs/spfx/release-1.4.1.md          | 9 +++++++++
 docs/spfx/release-1.5.0.md          | 9 +++++++++
 docs/spfx/release-1.5.1.md          | 9 +++++++++
 docs/spfx/release-1.6.0.md          | 9 +++++++++
 docs/spfx/release-1.7.0.md          | 9 +++++++++
 docs/spfx/release-1.7.1.md          | 9 +++++++++
 docs/spfx/release-1.8.0.md          | 9 +++++++++
 docs/spfx/release-1.8.1.md          | 9 +++++++++
 docs/spfx/release-1.8.2.md          | 9 +++++++++
 docs/spfx/release-1.9.1.md          | 9 +++++++++
 39 files changed, 351 insertions(+)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 6267bcdd7d..778b44d1fc 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -31,6 +31,15 @@ In the project's **package.json** file, identify all SPFx vTODO: {version-previo
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 TODO:
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 35ce53bcb8..0ebd21ce0d 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx pre-v1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 You can get the updated npm packages and use them in the local workbench, and everything should be fine. However, the rollout of the code to the servers will be done in stages over the course of several days. By sometime next week 100% of the farms should have it. We do this to monitor the rollout and make sure we don't have any issues.
diff --git a/docs/spfx/release-1.1.0.md b/docs/spfx/release-1.1.0.md
index 017e3aa7d7..7dde903398 100644
--- a/docs/spfx/release-1.1.0.md
+++ b/docs/spfx/release-1.1.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.0 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SPFx Extensions (developer preview)
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index d3b939845c..770903d4fa 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.9.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Create Search Extensions (dev preview)
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 974050813b..0b8e14f8db 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -35,6 +35,15 @@ In the project's **package.json** file, identify all SPFx v1.10 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Supporting SharePoint Framework solutions in AppSource and in Marketplace
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 3f4bf14fac..065f85f7f5 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.11.0 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - The **Sync to Teams** button in the Tenant App Catalog will use the Teams app manifest defined in the solution if present to create and publish a Teams app package to Microsoft Teams. If an app manifest file is not present, SharePoint will dynamically generate one.
diff --git a/docs/spfx/release-1.13.0.md b/docs/spfx/release-1.13.0.md
index a577af60ac..c70dc15e23 100644
--- a/docs/spfx/release-1.13.0.md
+++ b/docs/spfx/release-1.13.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.12.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - The new feature of this release is the extensibility model for the upcoming Viva Connections feature. The beta will allow you to create Adaptive Card Extensions (ACEs) and test them in the hosted workbench.
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index edf26d9883..16719da341 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.13 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - 1.13.0 for "Create a subfolder with solution name" does not work
diff --git a/docs/spfx/release-1.14.0.md b/docs/spfx/release-1.14.0.md
index 293517b638..0a1ce22169 100644
--- a/docs/spfx/release-1.14.0.md
+++ b/docs/spfx/release-1.14.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.13.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Adaptive Card Extension updates for Viva Connections
diff --git a/docs/spfx/release-1.15.0.md b/docs/spfx/release-1.15.0.md
index 9641ee0e84..745f3ab5c9 100644
--- a/docs/spfx/release-1.15.0.md
+++ b/docs/spfx/release-1.15.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.14 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Form Customizer Extension
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index ea755382a7..65774453a9 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.15.0 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Enable Service Principal Registration at Permission Scope Approval Time
diff --git a/docs/spfx/release-1.16.0.md b/docs/spfx/release-1.16.0.md
index 99eb1bb61c..0dac436c5c 100644
--- a/docs/spfx/release-1.16.0.md
+++ b/docs/spfx/release-1.16.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.15.2 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Publish Teams solutions build with SPFx to Outlook and Office
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index 1d9d6f100a..c2eaac001a 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.16 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Promoting `config/sass.json` file
diff --git a/docs/spfx/release-1.17.0.md b/docs/spfx/release-1.17.0.md
index bc3bd02c01..8b88e4dc3c 100644
--- a/docs/spfx/release-1.17.0.md
+++ b/docs/spfx/release-1.17.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.16.1 packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - Updates and improvements on building Microsoft 365 wide experiences with **Microsoft Teams apps build with SharePoint Framework** – This model enables you to build auto-hosted apps in Microsoft 365, which are extended across Microsoft Teams, Outlook and Office 365 app (office.com). Any Microsoft Teams app build with SharePoint Framework is automatically now compliant with the requirements to get the app exposed across Microsoft 365.
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index b1c0adb54b..f1cb4b7d83 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.17 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index a556ec9b4e..851976396e 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 2f2ea1726d..17a3f88193 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index d7e89e2187..f440e7ae49 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -42,6 +42,15 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Enable Strict Null Check for the generated solutions
diff --git a/docs/spfx/release-1.18.0.md b/docs/spfx/release-1.18.0.md
index 0dd5414583..d21c9c73d1 100644
--- a/docs/spfx/release-1.18.0.md
+++ b/docs/spfx/release-1.18.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.17.x packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 Related updated documentation for the 1.18.0 release:
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index ac3110852c..740e360bec 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Partial Support for Teams JS SDK in Adaptive Card Extensions (Mobile only)
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index be708a1224..3eb40a3c87 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Adding support of Yeoman generator v5.x
diff --git a/docs/spfx/release-1.19.0.md b/docs/spfx/release-1.19.0.md
index 81f207b11f..fd0c785658 100644
--- a/docs/spfx/release-1.19.0.md
+++ b/docs/spfx/release-1.19.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.18.x packages. For
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### New Data Visualization Card Template for Adaptive Card Extensions
diff --git a/docs/spfx/release-1.20.0.md b/docs/spfx/release-1.20.0.md
index d688f4995e..c716e8ea98 100644
--- a/docs/spfx/release-1.20.0.md
+++ b/docs/spfx/release-1.20.0.md
@@ -38,6 +38,15 @@ In the project's **package.json** file, identify all SPFx v1.19 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### New Data Visualization Card options for Viva Connections
diff --git a/docs/spfx/release-1.21.0.md b/docs/spfx/release-1.21.0.md
index d532ddc470..15553cff47 100644
--- a/docs/spfx/release-1.21.0.md
+++ b/docs/spfx/release-1.21.0.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Node.js v22 support
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index b84662f003..0b0fa2d81e 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.21 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 1fb1465bf6..6e0befe0f8 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 55c7e7fad6..2f4f016586 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -41,6 +41,15 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Fixed Issues
 
 Starting January 2026, we are introducing a monthly minor release cycle focused on keeping the SharePoint Framework developer environment clean from known npm vulnerabilities. The goal is to avoid confusion when npm audit reports issues during solution scaffolding on local development machines.
diff --git a/docs/spfx/release-1.3.0.md b/docs/spfx/release-1.3.0.md
index 18fa1f9f1f..f07fcf7be0 100644
--- a/docs/spfx/release-1.3.0.md
+++ b/docs/spfx/release-1.3.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.1 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SharePoint Extensions (general availability)
diff --git a/docs/spfx/release-1.4.0.md b/docs/spfx/release-1.4.0.md
index ce55e6865f..0d13ace2bf 100644
--- a/docs/spfx/release-1.4.0.md
+++ b/docs/spfx/release-1.4.0.md
@@ -28,6 +28,15 @@ In the project's **package.json** file, identify all SPFx v1.3 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### @microsoft/sp-tslint-rules
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index aec7c5cfc4..d5e2553ad6 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -28,6 +28,15 @@ In the project's **package.json** file, identify all SPFx v1.4 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Node v8 (LTS) and NPM v5 Support
diff --git a/docs/spfx/release-1.5.0.md b/docs/spfx/release-1.5.0.md
index 49dbeae050..c05ad5c14f 100644
--- a/docs/spfx/release-1.5.0.md
+++ b/docs/spfx/release-1.5.0.md
@@ -51,6 +51,15 @@ 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)]
 
+> [!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.
+
 ## New features and capabilities
 
 ### Ship vs. Beta APIs are now separate packages
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index c8349b11f2..3519d52a57 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.5 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Fixed the issue in the yeoman generator that blocked you from creating different types of components in your package.
diff --git a/docs/spfx/release-1.6.0.md b/docs/spfx/release-1.6.0.md
index ebec1c9ff5..5c966c8e0e 100644
--- a/docs/spfx/release-1.6.0.md
+++ b/docs/spfx/release-1.6.0.md
@@ -33,6 +33,15 @@ In the project's **package.json** file, identify all SPFx v1.5.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Web API (general availability)
diff --git a/docs/spfx/release-1.7.0.md b/docs/spfx/release-1.7.0.md
index cca1d0c389..4fc95beb03 100644
--- a/docs/spfx/release-1.7.0.md
+++ b/docs/spfx/release-1.7.0.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.6 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### Dynamic Data
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index f2670b3bfe..add7a8688f 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.7 packages. For eac
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Update title of user data property title in dynamic data
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 41aecf5185..06f025020d 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -53,6 +53,15 @@ We'll release more updated documentation and guidance videos during upcoming day
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 ### SPFx development for Teams tabs (General Availability)
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 904c3f6097..8f7e736bbf 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.0 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Fixed: Not able to set up SharePoint Server 2016 or SharePoint Server 2019 on premises using **\@microsoft/sharepoint** Yeoman generator  (two issues mentioned – incorrect SupportedHosts property and incorrect reference to sp-property-pane)
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 44ebf114b7..20fb0af670 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.1 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## Changes in this release
 
 - Released the `context.microsoftTeams` property to generally available (GA).
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index d759074ec6..1aede9e228 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -30,6 +30,15 @@ In the project's **package.json** file, identify all SPFx v1.8.2 packages. For e
 
 [!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.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.
+
 ## New features and capabilities
 
 - **Library Components (GA)**

From 1dd128e1c4cf6394455777472aebd8fcbd429156 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 14:44:52 +0100
Subject: [PATCH 06/11] Rename snippet from spfx-release-upgrade-tip to
 spfx-release-upgrade-warning

The snippet now contains a WARNING, so the filename should reflect that.
Updated all references across release pages and the template.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template                             | 2 +-
 docs/spfx/release-1.0.0.md                                      | 2 +-
 docs/spfx/release-1.1.0.md                                      | 2 +-
 docs/spfx/release-1.10.0.md                                     | 2 +-
 docs/spfx/release-1.11.0.md                                     | 2 +-
 docs/spfx/release-1.12.1.md                                     | 2 +-
 docs/spfx/release-1.13.0.md                                     | 2 +-
 docs/spfx/release-1.13.1.md                                     | 2 +-
 docs/spfx/release-1.14.0.md                                     | 2 +-
 docs/spfx/release-1.15.0.md                                     | 2 +-
 docs/spfx/release-1.15.2.md                                     | 2 +-
 docs/spfx/release-1.16.0.md                                     | 2 +-
 docs/spfx/release-1.16.1.md                                     | 2 +-
 docs/spfx/release-1.17.0.md                                     | 2 +-
 docs/spfx/release-1.17.1.md                                     | 2 +-
 docs/spfx/release-1.17.2.md                                     | 2 +-
 docs/spfx/release-1.17.3.md                                     | 2 +-
 docs/spfx/release-1.17.4.md                                     | 2 +-
 docs/spfx/release-1.18.0.md                                     | 2 +-
 docs/spfx/release-1.18.1.md                                     | 2 +-
 docs/spfx/release-1.18.2.md                                     | 2 +-
 docs/spfx/release-1.19.0.md                                     | 2 +-
 docs/spfx/release-1.20.0.md                                     | 2 +-
 docs/spfx/release-1.21.0.md                                     | 2 +-
 docs/spfx/release-1.21.1.md                                     | 2 +-
 docs/spfx/release-1.22.1.md                                     | 2 +-
 docs/spfx/release-1.22.2.md                                     | 2 +-
 docs/spfx/release-1.3.0.md                                      | 2 +-
 docs/spfx/release-1.4.0.md                                      | 2 +-
 docs/spfx/release-1.4.1.md                                      | 2 +-
 docs/spfx/release-1.5.0.md                                      | 2 +-
 docs/spfx/release-1.5.1.md                                      | 2 +-
 docs/spfx/release-1.6.0.md                                      | 2 +-
 docs/spfx/release-1.7.0.md                                      | 2 +-
 docs/spfx/release-1.7.1.md                                      | 2 +-
 docs/spfx/release-1.8.0.md                                      | 2 +-
 docs/spfx/release-1.8.1.md                                      | 2 +-
 docs/spfx/release-1.8.2.md                                      | 2 +-
 docs/spfx/release-1.9.1.md                                      | 2 +-
 ...x-release-upgrade-tip.md => spfx-release-upgrade-warning.md} | 0
 40 files changed, 39 insertions(+), 39 deletions(-)
 rename includes/snippets/{spfx-release-upgrade-tip.md => spfx-release-upgrade-warning.md} (100%)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 778b44d1fc..5196dbd501 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -29,7 +29,7 @@ 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:
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 0ebd21ce0d..3e348e15d8 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.1.0.md b/docs/spfx/release-1.1.0.md
index 7dde903398..f2b16b0fcf 100644
--- a/docs/spfx/release-1.1.0.md
+++ b/docs/spfx/release-1.1.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index 770903d4fa..7f1f426a05 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 0b8e14f8db..391e32659c 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -33,7 +33,7 @@ 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:
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 065f85f7f5..e097456347 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.13.0.md b/docs/spfx/release-1.13.0.md
index c70dc15e23..4cf6ecd904 100644
--- a/docs/spfx/release-1.13.0.md
+++ b/docs/spfx/release-1.13.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index 16719da341..397ef11baf 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.14.0.md b/docs/spfx/release-1.14.0.md
index 0a1ce22169..9bc5a2710e 100644
--- a/docs/spfx/release-1.14.0.md
+++ b/docs/spfx/release-1.14.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.15.0.md b/docs/spfx/release-1.15.0.md
index 745f3ab5c9..def7137a10 100644
--- a/docs/spfx/release-1.15.0.md
+++ b/docs/spfx/release-1.15.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index 65774453a9..647484ecda 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.16.0.md b/docs/spfx/release-1.16.0.md
index 0dac436c5c..80ac26bdc0 100644
--- a/docs/spfx/release-1.16.0.md
+++ b/docs/spfx/release-1.16.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index c2eaac001a..d6a144f6a2 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.17.0.md b/docs/spfx/release-1.17.0.md
index 8b88e4dc3c..3a86fe1f64 100644
--- a/docs/spfx/release-1.17.0.md
+++ b/docs/spfx/release-1.17.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index f1cb4b7d83..68bd59d100 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index 851976396e..7e1a54040d 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 17a3f88193..72768ca511 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index f440e7ae49..13833ebd4e 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -40,7 +40,7 @@ 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:
diff --git a/docs/spfx/release-1.18.0.md b/docs/spfx/release-1.18.0.md
index d21c9c73d1..07203b91db 100644
--- a/docs/spfx/release-1.18.0.md
+++ b/docs/spfx/release-1.18.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index 740e360bec..a52144e81e 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index 3eb40a3c87..d3baa1291f 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.19.0.md b/docs/spfx/release-1.19.0.md
index fd0c785658..c5c8217095 100644
--- a/docs/spfx/release-1.19.0.md
+++ b/docs/spfx/release-1.19.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.20.0.md b/docs/spfx/release-1.20.0.md
index c716e8ea98..0ba307c2bf 100644
--- a/docs/spfx/release-1.20.0.md
+++ b/docs/spfx/release-1.20.0.md
@@ -36,7 +36,7 @@ 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:
diff --git a/docs/spfx/release-1.21.0.md b/docs/spfx/release-1.21.0.md
index 15553cff47..3994607d3f 100644
--- a/docs/spfx/release-1.21.0.md
+++ b/docs/spfx/release-1.21.0.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index 0b0fa2d81e..5e78580030 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 6e0befe0f8..944e613674 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 2f4f016586..09ffbe3a87 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -39,7 +39,7 @@ 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:
diff --git a/docs/spfx/release-1.3.0.md b/docs/spfx/release-1.3.0.md
index f07fcf7be0..01a0910243 100644
--- a/docs/spfx/release-1.3.0.md
+++ b/docs/spfx/release-1.3.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.4.0.md b/docs/spfx/release-1.4.0.md
index 0d13ace2bf..27f54fccf3 100644
--- a/docs/spfx/release-1.4.0.md
+++ b/docs/spfx/release-1.4.0.md
@@ -26,7 +26,7 @@ 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:
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index d5e2553ad6..1393331ed5 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -26,7 +26,7 @@ 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:
diff --git a/docs/spfx/release-1.5.0.md b/docs/spfx/release-1.5.0.md
index c05ad5c14f..34fd50230f 100644
--- a/docs/spfx/release-1.5.0.md
+++ b/docs/spfx/release-1.5.0.md
@@ -49,7 +49,7 @@ 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:
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index 3519d52a57..0fdf5eb253 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.6.0.md b/docs/spfx/release-1.6.0.md
index 5c966c8e0e..cf18c739a8 100644
--- a/docs/spfx/release-1.6.0.md
+++ b/docs/spfx/release-1.6.0.md
@@ -31,7 +31,7 @@ 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:
diff --git a/docs/spfx/release-1.7.0.md b/docs/spfx/release-1.7.0.md
index 4fc95beb03..60df0b493f 100644
--- a/docs/spfx/release-1.7.0.md
+++ b/docs/spfx/release-1.7.0.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index add7a8688f..e3dbd1f0dc 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 06f025020d..8c9db70032 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -51,7 +51,7 @@ 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:
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 8f7e736bbf..98dcea764a 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 20fb0af670..7dfa737d4d 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -28,7 +28,7 @@ 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:
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index 1aede9e228..2fc0716a66 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -28,7 +28,7 @@ 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:
diff --git a/includes/snippets/spfx-release-upgrade-tip.md b/includes/snippets/spfx-release-upgrade-warning.md
similarity index 100%
rename from includes/snippets/spfx-release-upgrade-tip.md
rename to includes/snippets/spfx-release-upgrade-warning.md

From f2ddca89d9e0788ea867bac7ba803d33088059d2 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 15:04:27 +0100
Subject: [PATCH 07/11] Add CLI for Microsoft 365 community disclaimer to
 release pages

Include the existing pnp-o365cli NOTE snippet after the upgrade TIP
on each SPFx release page and the template.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template | 2 ++
 docs/spfx/release-1.0.0.md          | 2 ++
 docs/spfx/release-1.1.0.md          | 2 ++
 docs/spfx/release-1.10.0.md         | 2 ++
 docs/spfx/release-1.11.0.md         | 2 ++
 docs/spfx/release-1.12.1.md         | 2 ++
 docs/spfx/release-1.13.0.md         | 2 ++
 docs/spfx/release-1.13.1.md         | 2 ++
 docs/spfx/release-1.14.0.md         | 2 ++
 docs/spfx/release-1.15.0.md         | 2 ++
 docs/spfx/release-1.15.2.md         | 2 ++
 docs/spfx/release-1.16.0.md         | 2 ++
 docs/spfx/release-1.16.1.md         | 2 ++
 docs/spfx/release-1.17.0.md         | 2 ++
 docs/spfx/release-1.17.1.md         | 2 ++
 docs/spfx/release-1.17.2.md         | 2 ++
 docs/spfx/release-1.17.3.md         | 2 ++
 docs/spfx/release-1.17.4.md         | 2 ++
 docs/spfx/release-1.18.0.md         | 2 ++
 docs/spfx/release-1.18.1.md         | 2 ++
 docs/spfx/release-1.18.2.md         | 2 ++
 docs/spfx/release-1.19.0.md         | 2 ++
 docs/spfx/release-1.20.0.md         | 2 ++
 docs/spfx/release-1.21.0.md         | 2 ++
 docs/spfx/release-1.21.1.md         | 2 ++
 docs/spfx/release-1.22.1.md         | 2 ++
 docs/spfx/release-1.22.2.md         | 2 ++
 docs/spfx/release-1.3.0.md          | 2 ++
 docs/spfx/release-1.4.0.md          | 2 ++
 docs/spfx/release-1.4.1.md          | 2 ++
 docs/spfx/release-1.5.0.md          | 2 ++
 docs/spfx/release-1.5.1.md          | 2 ++
 docs/spfx/release-1.6.0.md          | 2 ++
 docs/spfx/release-1.7.0.md          | 2 ++
 docs/spfx/release-1.7.1.md          | 2 ++
 docs/spfx/release-1.8.0.md          | 2 ++
 docs/spfx/release-1.8.1.md          | 2 ++
 docs/spfx/release-1.8.2.md          | 2 ++
 docs/spfx/release-1.9.1.md          | 2 ++
 39 files changed, 78 insertions(+)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 5196dbd501..100211aa0f 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -40,6 +40,8 @@ In the project's **package.json** file, identify all SPFx vTODO: {version-previo
 >
 > 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
 
 TODO:
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index 3e348e15d8..de5e3fb852 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx pre-v1 packages. For e
 >
 > 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
 
 You can get the updated npm packages and use them in the local workbench, and everything should be fine. However, the rollout of the code to the servers will be done in stages over the course of several days. By sometime next week 100% of the farms should have it. We do this to monitor the rollout and make sure we don't have any issues.
diff --git a/docs/spfx/release-1.1.0.md b/docs/spfx/release-1.1.0.md
index f2b16b0fcf..4704f722cf 100644
--- a/docs/spfx/release-1.1.0.md
+++ b/docs/spfx/release-1.1.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.0 packages. For eac
 >
 > 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
 
 ### SPFx Extensions (developer preview)
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index 7f1f426a05..4693614659 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.9.1 packages. For e
 >
 > 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
 
 - Create Search Extensions (dev preview)
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 391e32659c..720d007875 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -44,6 +44,8 @@ In the project's **package.json** file, identify all SPFx v1.10 packages. For ea
 >
 > 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
 
 - Supporting SharePoint Framework solutions in AppSource and in Marketplace
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index e097456347..68f2aa8d75 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.11.0 packages. For
 >
 > 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
 
 - The **Sync to Teams** button in the Tenant App Catalog will use the Teams app manifest defined in the solution if present to create and publish a Teams app package to Microsoft Teams. If an app manifest file is not present, SharePoint will dynamically generate one.
diff --git a/docs/spfx/release-1.13.0.md b/docs/spfx/release-1.13.0.md
index 4cf6ecd904..5a001b3c5a 100644
--- a/docs/spfx/release-1.13.0.md
+++ b/docs/spfx/release-1.13.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.12.1 packages. For
 >
 > 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
 
 - The new feature of this release is the extensibility model for the upcoming Viva Connections feature. The beta will allow you to create Adaptive Card Extensions (ACEs) and test them in the hosted workbench.
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index 397ef11baf..53e51bc48c 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.13 packages. For ea
 >
 > 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
 
 - 1.13.0 for "Create a subfolder with solution name" does not work
diff --git a/docs/spfx/release-1.14.0.md b/docs/spfx/release-1.14.0.md
index 9bc5a2710e..cac9f87db0 100644
--- a/docs/spfx/release-1.14.0.md
+++ b/docs/spfx/release-1.14.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.13.1 packages. For
 >
 > 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
 
 ### Adaptive Card Extension updates for Viva Connections
diff --git a/docs/spfx/release-1.15.0.md b/docs/spfx/release-1.15.0.md
index def7137a10..01b56a2281 100644
--- a/docs/spfx/release-1.15.0.md
+++ b/docs/spfx/release-1.15.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.14 packages. For ea
 >
 > 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
 
 ### Form Customizer Extension
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index 647484ecda..f225345cc6 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.15.0 packages. For
 >
 > 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
 
 ### Enable Service Principal Registration at Permission Scope Approval Time
diff --git a/docs/spfx/release-1.16.0.md b/docs/spfx/release-1.16.0.md
index 80ac26bdc0..33fd1cc594 100644
--- a/docs/spfx/release-1.16.0.md
+++ b/docs/spfx/release-1.16.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.15.2 packages. For
 >
 > 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
 
 ### Publish Teams solutions build with SPFx to Outlook and Office
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index d6a144f6a2..f6da25ad9c 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.16 packages. For ea
 >
 > 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
 
 ### Promoting `config/sass.json` file
diff --git a/docs/spfx/release-1.17.0.md b/docs/spfx/release-1.17.0.md
index 3a86fe1f64..f53770f53a 100644
--- a/docs/spfx/release-1.17.0.md
+++ b/docs/spfx/release-1.17.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.16.1 packages. For
 >
 > 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
 
 - Updates and improvements on building Microsoft 365 wide experiences with **Microsoft Teams apps build with SharePoint Framework** – This model enables you to build auto-hosted apps in Microsoft 365, which are extended across Microsoft Teams, Outlook and Office 365 app (office.com). Any Microsoft Teams app build with SharePoint Framework is automatically now compliant with the requirements to get the app exposed across Microsoft 365.
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index 68bd59d100..e98731a0a3 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -50,6 +50,8 @@ In the project's **package.json** file, identify all SPFx v1.17 packages. For ea
 >
 > 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
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index 7e1a54040d..65f4782637 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -51,6 +51,8 @@ npm install @microsoft/generator-sharepoint@latest --global
 >
 > 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
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 72768ca511..1e789f562b 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -51,6 +51,8 @@ npm install @microsoft/generator-sharepoint@latest --global
 >
 > 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
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index 13833ebd4e..d1393bfab1 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -51,6 +51,8 @@ npm install @microsoft/generator-sharepoint@latest --global
 >
 > 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
 
 ### Enable Strict Null Check for the generated solutions
diff --git a/docs/spfx/release-1.18.0.md b/docs/spfx/release-1.18.0.md
index 07203b91db..5a0f0a4ce7 100644
--- a/docs/spfx/release-1.18.0.md
+++ b/docs/spfx/release-1.18.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.17.x packages. For
 >
 > 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
 
 Related updated documentation for the 1.18.0 release:
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index a52144e81e..52f2f88d43 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 >
 > 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
 
 ### Partial Support for Teams JS SDK in Adaptive Card Extensions (Mobile only)
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index d3baa1291f..e838b0e674 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 >
 > 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
 
 ### Adding support of Yeoman generator v5.x
diff --git a/docs/spfx/release-1.19.0.md b/docs/spfx/release-1.19.0.md
index c5c8217095..4b8747573e 100644
--- a/docs/spfx/release-1.19.0.md
+++ b/docs/spfx/release-1.19.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.18.x packages. For
 >
 > 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
 
 ### New Data Visualization Card Template for Adaptive Card Extensions
diff --git a/docs/spfx/release-1.20.0.md b/docs/spfx/release-1.20.0.md
index 0ba307c2bf..80ad7f67e8 100644
--- a/docs/spfx/release-1.20.0.md
+++ b/docs/spfx/release-1.20.0.md
@@ -47,6 +47,8 @@ In the project's **package.json** file, identify all SPFx v1.19 packages. For ea
 >
 > 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
 
 ### New Data Visualization Card options for Viva Connections
diff --git a/docs/spfx/release-1.21.0.md b/docs/spfx/release-1.21.0.md
index 3994607d3f..bb3e2a0546 100644
--- a/docs/spfx/release-1.21.0.md
+++ b/docs/spfx/release-1.21.0.md
@@ -50,6 +50,8 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
 >
 > 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
 
 ### Node.js v22 support
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index 5e78580030..73bce279cc 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -50,6 +50,8 @@ In the project's **package.json** file, identify all SPFx v1.21 packages. For ea
 >
 > 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
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 944e613674..07edc55178 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -50,6 +50,8 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 >
 > 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
 
 Here's a list of specific issues fixed around SharePoint Framework since the previous public release.
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 09ffbe3a87..670efb8b82 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -50,6 +50,8 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 >
 > 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
 
 Starting January 2026, we are introducing a monthly minor release cycle focused on keeping the SharePoint Framework developer environment clean from known npm vulnerabilities. The goal is to avoid confusion when npm audit reports issues during solution scaffolding on local development machines.
diff --git a/docs/spfx/release-1.3.0.md b/docs/spfx/release-1.3.0.md
index 01a0910243..94baee1f73 100644
--- a/docs/spfx/release-1.3.0.md
+++ b/docs/spfx/release-1.3.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.1 packages. For eac
 >
 > 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
 
 ### SharePoint Extensions (general availability)
diff --git a/docs/spfx/release-1.4.0.md b/docs/spfx/release-1.4.0.md
index 27f54fccf3..8be13996c2 100644
--- a/docs/spfx/release-1.4.0.md
+++ b/docs/spfx/release-1.4.0.md
@@ -37,6 +37,8 @@ In the project's **package.json** file, identify all SPFx v1.3 packages. For eac
 >
 > 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
 
 ### @microsoft/sp-tslint-rules
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index 1393331ed5..84488a89ba 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -37,6 +37,8 @@ In the project's **package.json** file, identify all SPFx v1.4 packages. For eac
 >
 > 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
 
 ### Node v8 (LTS) and NPM v5 Support
diff --git a/docs/spfx/release-1.5.0.md b/docs/spfx/release-1.5.0.md
index 34fd50230f..14b9c6767b 100644
--- a/docs/spfx/release-1.5.0.md
+++ b/docs/spfx/release-1.5.0.md
@@ -60,6 +60,8 @@ Key changes are around the introduction of the new *plusbeta* model and many oth
 >
 > 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
 
 ### Ship vs. Beta APIs are now separate packages
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index 0fdf5eb253..15a68b958e 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.5 packages. For eac
 >
 > 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
 
 - Fixed the issue in the yeoman generator that blocked you from creating different types of components in your package.
diff --git a/docs/spfx/release-1.6.0.md b/docs/spfx/release-1.6.0.md
index cf18c739a8..7884827dc6 100644
--- a/docs/spfx/release-1.6.0.md
+++ b/docs/spfx/release-1.6.0.md
@@ -42,6 +42,8 @@ In the project's **package.json** file, identify all SPFx v1.5.1 packages. For e
 >
 > 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
 
 ### Web API (general availability)
diff --git a/docs/spfx/release-1.7.0.md b/docs/spfx/release-1.7.0.md
index 60df0b493f..2857e2c129 100644
--- a/docs/spfx/release-1.7.0.md
+++ b/docs/spfx/release-1.7.0.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.6 packages. For eac
 >
 > 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
 
 ### Dynamic Data
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index e3dbd1f0dc..4e59f27534 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.7 packages. For eac
 >
 > 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
 
 - Update title of user data property title in dynamic data
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 8c9db70032..3fb1c4c980 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -62,6 +62,8 @@ We'll release more updated documentation and guidance videos during upcoming day
 >
 > 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
 
 ### SPFx development for Teams tabs (General Availability)
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 98dcea764a..65fba6273c 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.8.0 packages. For e
 >
 > 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
 
 - Fixed: Not able to set up SharePoint Server 2016 or SharePoint Server 2019 on premises using **\@microsoft/sharepoint** Yeoman generator  (two issues mentioned – incorrect SupportedHosts property and incorrect reference to sp-property-pane)
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 7dfa737d4d..84877e723d 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.8.1 packages. For e
 >
 > 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
 
 - Released the `context.microsoftTeams` property to generally available (GA).
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index 2fc0716a66..312bb397aa 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -39,6 +39,8 @@ In the project's **package.json** file, identify all SPFx v1.8.2 packages. For e
 >
 > 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
 
 - **Library Components (GA)**

From 957878fce9f8ab556a2296d5e8d0cff9b7b9aaad Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Tue, 23 Jun 2026 15:21:37 +0100
Subject: [PATCH 08/11] Fix broken bookmark link in release-1.15.2

Update anchor from Azure AD to Entra ID to match the renamed heading
in use-aadhttpclient.md.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-1.15.2.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index f225345cc6..532eb24da2 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -61,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
 

From c9853a94e3854910a06fba89454498685c530635 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Wed, 24 Jun 2026 14:12:25 +0100
Subject: [PATCH 09/11] Add upgrade warning and TIP to release-1.22.0 and
 release-1.23.0

These pages were missing the warning snippet, version-specific TIP,
and community disclaimer that were added to all other release pages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-1.22.0.md | 13 +++++++++++++
 docs/spfx/release-1.23.0.md | 13 +++++++++++++
 2 files changed, 26 insertions(+)

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.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

From 520e4c6fa0fb94d1022ad38dd1ea72ebb0d86c2a Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Mon, 29 Jun 2026 11:30:00 +0100
Subject: [PATCH 10/11] Update TIP text, rewrite migration page, and fix
 release-1.22.0

- Update TIP description across all release pages to mention the
  single script output
- Rewrite migrate-gulptoolchain-hefttoolchain.md to direct users to
  CLI for Microsoft 365 instead of manual step-by-step instructions
- Update release-1.22.0 upgrade section to reference migration page
  after the warning/tip/disclaimer block
- Remove redundant 'See more details' section from release-1.22.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-0.0.0.md.template           |   2 +-
 docs/spfx/release-1.0.0.md                    |   2 +-
 docs/spfx/release-1.1.0.md                    |   2 +-
 docs/spfx/release-1.10.0.md                   |   2 +-
 docs/spfx/release-1.11.0.md                   |   2 +-
 docs/spfx/release-1.12.1.md                   |   2 +-
 docs/spfx/release-1.13.0.md                   |   2 +-
 docs/spfx/release-1.13.1.md                   |   2 +-
 docs/spfx/release-1.14.0.md                   |   2 +-
 docs/spfx/release-1.15.0.md                   |   2 +-
 docs/spfx/release-1.15.2.md                   |   2 +-
 docs/spfx/release-1.16.0.md                   |   2 +-
 docs/spfx/release-1.16.1.md                   |   2 +-
 docs/spfx/release-1.17.0.md                   |   2 +-
 docs/spfx/release-1.17.1.md                   |   2 +-
 docs/spfx/release-1.17.2.md                   |   2 +-
 docs/spfx/release-1.17.3.md                   |   2 +-
 docs/spfx/release-1.17.4.md                   |   2 +-
 docs/spfx/release-1.18.0.md                   |   2 +-
 docs/spfx/release-1.18.1.md                   |   2 +-
 docs/spfx/release-1.18.2.md                   |   2 +-
 docs/spfx/release-1.19.0.md                   |   2 +-
 docs/spfx/release-1.20.0.md                   |   2 +-
 docs/spfx/release-1.21.0.md                   |   2 +-
 docs/spfx/release-1.21.1.md                   |   2 +-
 docs/spfx/release-1.22.0.md                   |  12 +-
 docs/spfx/release-1.22.1.md                   |   2 +-
 docs/spfx/release-1.22.2.md                   |   2 +-
 docs/spfx/release-1.23.0.md                   |   2 +-
 docs/spfx/release-1.3.0.md                    |   2 +-
 docs/spfx/release-1.4.0.md                    |   2 +-
 docs/spfx/release-1.4.1.md                    |   2 +-
 docs/spfx/release-1.5.0.md                    |   2 +-
 docs/spfx/release-1.5.1.md                    |   2 +-
 docs/spfx/release-1.6.0.md                    |   2 +-
 docs/spfx/release-1.7.0.md                    |   2 +-
 docs/spfx/release-1.7.1.md                    |   2 +-
 docs/spfx/release-1.8.0.md                    |   2 +-
 docs/spfx/release-1.8.1.md                    |   2 +-
 docs/spfx/release-1.8.2.md                    |   2 +-
 docs/spfx/release-1.9.1.md                    |   2 +-
 .../migrate-gulptoolchain-hefttoolchain.md    | 208 +++---------------
 42 files changed, 72 insertions(+), 228 deletions(-)

diff --git a/docs/spfx/release-0.0.0.md.template b/docs/spfx/release-0.0.0.md.template
index 100211aa0f..929d63b57b 100644
--- a/docs/spfx/release-0.0.0.md.template
+++ b/docs/spfx/release-0.0.0.md.template
@@ -38,7 +38,7 @@ In the project's **package.json** file, identify all SPFx vTODO: {version-previo
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.0.0.md b/docs/spfx/release-1.0.0.md
index de5e3fb852..71fec62d7b 100644
--- a/docs/spfx/release-1.0.0.md
+++ b/docs/spfx/release-1.0.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx pre-v1 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.1.0.md b/docs/spfx/release-1.1.0.md
index 4704f722cf..322e7d9bfd 100644
--- a/docs/spfx/release-1.1.0.md
+++ b/docs/spfx/release-1.1.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.0 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.10.0.md b/docs/spfx/release-1.10.0.md
index 4693614659..730096c7b0 100644
--- a/docs/spfx/release-1.10.0.md
+++ b/docs/spfx/release-1.10.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.9.1 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.11.0.md b/docs/spfx/release-1.11.0.md
index 720d007875..e5b9b0b8ab 100644
--- a/docs/spfx/release-1.11.0.md
+++ b/docs/spfx/release-1.11.0.md
@@ -42,7 +42,7 @@ In the project's **package.json** file, identify all SPFx v1.10 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.12.1.md b/docs/spfx/release-1.12.1.md
index 68f2aa8d75..e2b5451d07 100644
--- a/docs/spfx/release-1.12.1.md
+++ b/docs/spfx/release-1.12.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.11.0 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.13.0.md b/docs/spfx/release-1.13.0.md
index 5a001b3c5a..fe730d2c0b 100644
--- a/docs/spfx/release-1.13.0.md
+++ b/docs/spfx/release-1.13.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.12.1 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.13.1.md b/docs/spfx/release-1.13.1.md
index 53e51bc48c..9ff04906ae 100644
--- a/docs/spfx/release-1.13.1.md
+++ b/docs/spfx/release-1.13.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.13 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.14.0.md b/docs/spfx/release-1.14.0.md
index cac9f87db0..bb97e5de3b 100644
--- a/docs/spfx/release-1.14.0.md
+++ b/docs/spfx/release-1.14.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.13.1 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.15.0.md b/docs/spfx/release-1.15.0.md
index 01b56a2281..4d5cc2fcab 100644
--- a/docs/spfx/release-1.15.0.md
+++ b/docs/spfx/release-1.15.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.14 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.15.2.md b/docs/spfx/release-1.15.2.md
index 532eb24da2..534a0bf5e7 100644
--- a/docs/spfx/release-1.15.2.md
+++ b/docs/spfx/release-1.15.2.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.15.0 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.16.0.md b/docs/spfx/release-1.16.0.md
index 33fd1cc594..a097c8b241 100644
--- a/docs/spfx/release-1.16.0.md
+++ b/docs/spfx/release-1.16.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.15.2 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.16.1.md b/docs/spfx/release-1.16.1.md
index f6da25ad9c..dd98dfce86 100644
--- a/docs/spfx/release-1.16.1.md
+++ b/docs/spfx/release-1.16.1.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.16 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.17.0.md b/docs/spfx/release-1.17.0.md
index f53770f53a..4e9fdfd269 100644
--- a/docs/spfx/release-1.17.0.md
+++ b/docs/spfx/release-1.17.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.16.1 packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.17.1.md b/docs/spfx/release-1.17.1.md
index e98731a0a3..f686cdab04 100644
--- a/docs/spfx/release-1.17.1.md
+++ b/docs/spfx/release-1.17.1.md
@@ -48,7 +48,7 @@ In the project's **package.json** file, identify all SPFx v1.17 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.17.2.md b/docs/spfx/release-1.17.2.md
index 65f4782637..5016eec1c5 100644
--- a/docs/spfx/release-1.17.2.md
+++ b/docs/spfx/release-1.17.2.md
@@ -49,7 +49,7 @@ npm install @microsoft/generator-sharepoint@latest --global
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.17.3.md b/docs/spfx/release-1.17.3.md
index 1e789f562b..4bf110061c 100644
--- a/docs/spfx/release-1.17.3.md
+++ b/docs/spfx/release-1.17.3.md
@@ -49,7 +49,7 @@ npm install @microsoft/generator-sharepoint@latest --global
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.17.4.md b/docs/spfx/release-1.17.4.md
index d1393bfab1..d922283a96 100644
--- a/docs/spfx/release-1.17.4.md
+++ b/docs/spfx/release-1.17.4.md
@@ -49,7 +49,7 @@ npm install @microsoft/generator-sharepoint@latest --global
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.18.0.md b/docs/spfx/release-1.18.0.md
index 5a0f0a4ce7..13bac9cff9 100644
--- a/docs/spfx/release-1.18.0.md
+++ b/docs/spfx/release-1.18.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.17.x packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.18.1.md b/docs/spfx/release-1.18.1.md
index 52f2f88d43..506a3163b3 100644
--- a/docs/spfx/release-1.18.1.md
+++ b/docs/spfx/release-1.18.1.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.18.2.md b/docs/spfx/release-1.18.2.md
index e838b0e674..8f872ea394 100644
--- a/docs/spfx/release-1.18.2.md
+++ b/docs/spfx/release-1.18.2.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx packages. For each SPF
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.19.0.md b/docs/spfx/release-1.19.0.md
index 4b8747573e..6ff69bbd4e 100644
--- a/docs/spfx/release-1.19.0.md
+++ b/docs/spfx/release-1.19.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.18.x packages. For
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.20.0.md b/docs/spfx/release-1.20.0.md
index 80ad7f67e8..b18324fa3b 100644
--- a/docs/spfx/release-1.20.0.md
+++ b/docs/spfx/release-1.20.0.md
@@ -45,7 +45,7 @@ In the project's **package.json** file, identify all SPFx v1.19 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.21.0.md b/docs/spfx/release-1.21.0.md
index bb3e2a0546..00a7bd2110 100644
--- a/docs/spfx/release-1.21.0.md
+++ b/docs/spfx/release-1.21.0.md
@@ -48,7 +48,7 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.21.1.md b/docs/spfx/release-1.21.1.md
index 73bce279cc..7ddd779846 100644
--- a/docs/spfx/release-1.21.1.md
+++ b/docs/spfx/release-1.21.1.md
@@ -48,7 +48,7 @@ In the project's **package.json** file, identify all SPFx v1.21 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.22.0.md b/docs/spfx/release-1.22.0.md
index 86a1f03fca..12e1d1d32b 100644
--- a/docs/spfx/release-1.22.0.md
+++ b/docs/spfx/release-1.22.0.md
@@ -25,8 +25,6 @@ npm install @microsoft/generator-sharepoint@latest --global
 
 ## Upgrading projects from the SPFx v1.21.1 to v1.22.0 version
 
-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]
@@ -36,19 +34,17 @@ The upgrade steps required to convert a [gulp-based toolchain](toolchain/sharepo
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
+For an overview of what changes during this migration from the [Gulp-based toolchain](toolchain/sharepoint-framework-toolchain.md) to the [Heft-based toolchain](toolchain/sharepoint-framework-toolchain-rushstack-heft.md), see: [Migrate from the Gulp Toolchain to Heft Toolchain](toolchain/migrate-gulptoolchain-hefttoolchain.md).
+
 ## New features and capabilities
 
 ### Transitioning from Gulp-based toolchain to the Heft-based toolchain
 
-Starting with SPFx v1.22.0, new projects use Heft as the build task orchestrator instead of a [gulp-based toolchain](./toolchain/sharepoint-framework-toolchain.md) used in SPFx v1.0 - v1.21.1 releases. This change represents a fundamental shift in how SPFx projects are built, configured, and customized, though the underlying bundling technology (webpack) remains the same.
-
-See more details on this upcoming change from the following documentation:
-
-- [Heft-based toolchain (SPFx v1.22.0+)](./toolchain/sharepoint-framework-toolchain-rushstack-heft.md)
+Starting with SPFx v1.22.0, new projects use Heft as the build task orchestrator instead of the gulp-based toolchain used in SPFx v1.0 - v1.21.1 releases. This change represents a fundamental shift in how SPFx projects are built, configured, and customized, though the underlying bundling technology (webpack) remains the same.
 
 ### Addressing npm audit issues
 
diff --git a/docs/spfx/release-1.22.1.md b/docs/spfx/release-1.22.1.md
index 07edc55178..58d62d0871 100644
--- a/docs/spfx/release-1.22.1.md
+++ b/docs/spfx/release-1.22.1.md
@@ -48,7 +48,7 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.22.2.md b/docs/spfx/release-1.22.2.md
index 670efb8b82..0900260ed0 100644
--- a/docs/spfx/release-1.22.2.md
+++ b/docs/spfx/release-1.22.2.md
@@ -48,7 +48,7 @@ In the project's **package.json** file, identify all SPFx v1.22 packages. For ea
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.23.0.md b/docs/spfx/release-1.23.0.md
index d718d0347f..be4e0335fa 100644
--- a/docs/spfx/release-1.23.0.md
+++ b/docs/spfx/release-1.23.0.md
@@ -33,7 +33,7 @@ If you are upgrading from older than 1.22 version, please follow the upgrade ste
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.3.0.md b/docs/spfx/release-1.3.0.md
index 94baee1f73..b9ae6d6c78 100644
--- a/docs/spfx/release-1.3.0.md
+++ b/docs/spfx/release-1.3.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.1 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.4.0.md b/docs/spfx/release-1.4.0.md
index 8be13996c2..cf77414e79 100644
--- a/docs/spfx/release-1.4.0.md
+++ b/docs/spfx/release-1.4.0.md
@@ -35,7 +35,7 @@ In the project's **package.json** file, identify all SPFx v1.3 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.4.1.md b/docs/spfx/release-1.4.1.md
index 84488a89ba..8da5e4fad3 100644
--- a/docs/spfx/release-1.4.1.md
+++ b/docs/spfx/release-1.4.1.md
@@ -35,7 +35,7 @@ In the project's **package.json** file, identify all SPFx v1.4 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.5.0.md b/docs/spfx/release-1.5.0.md
index 14b9c6767b..adb3c00040 100644
--- a/docs/spfx/release-1.5.0.md
+++ b/docs/spfx/release-1.5.0.md
@@ -58,7 +58,7 @@ Key changes are around the introduction of the new *plusbeta* model and many oth
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.5.1.md b/docs/spfx/release-1.5.1.md
index 15a68b958e..cba3f5ff3f 100644
--- a/docs/spfx/release-1.5.1.md
+++ b/docs/spfx/release-1.5.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.5 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.6.0.md b/docs/spfx/release-1.6.0.md
index 7884827dc6..5fb23058c6 100644
--- a/docs/spfx/release-1.6.0.md
+++ b/docs/spfx/release-1.6.0.md
@@ -40,7 +40,7 @@ In the project's **package.json** file, identify all SPFx v1.5.1 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.7.0.md b/docs/spfx/release-1.7.0.md
index 2857e2c129..baeddd9900 100644
--- a/docs/spfx/release-1.7.0.md
+++ b/docs/spfx/release-1.7.0.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.6 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.7.1.md b/docs/spfx/release-1.7.1.md
index 4e59f27534..4ef17955c8 100644
--- a/docs/spfx/release-1.7.1.md
+++ b/docs/spfx/release-1.7.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.7 packages. For eac
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.8.0.md b/docs/spfx/release-1.8.0.md
index 3fb1c4c980..10f85d5acd 100644
--- a/docs/spfx/release-1.8.0.md
+++ b/docs/spfx/release-1.8.0.md
@@ -60,7 +60,7 @@ We'll release more updated documentation and guidance videos during upcoming day
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.8.1.md b/docs/spfx/release-1.8.1.md
index 65fba6273c..1e1f01c739 100644
--- a/docs/spfx/release-1.8.1.md
+++ b/docs/spfx/release-1.8.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.8.0 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.8.2.md b/docs/spfx/release-1.8.2.md
index 84877e723d..5d6f67ec1e 100644
--- a/docs/spfx/release-1.8.2.md
+++ b/docs/spfx/release-1.8.2.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.8.1 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/release-1.9.1.md b/docs/spfx/release-1.9.1.md
index 312bb397aa..7d0b23cd70 100644
--- a/docs/spfx/release-1.9.1.md
+++ b/docs/spfx/release-1.9.1.md
@@ -37,7 +37,7 @@ In the project's **package.json** file, identify all SPFx v1.8.2 packages. For e
 > 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.
+> This analyzes your project and outputs all required changes, including a single script to apply them in one go.
 
 [!INCLUDE [pnp-o365cli](../../includes/snippets/open-source/pnp-o365cli.md)]
 
diff --git a/docs/spfx/toolchain/migrate-gulptoolchain-hefttoolchain.md b/docs/spfx/toolchain/migrate-gulptoolchain-hefttoolchain.md
index 2626035bce..006a8d9025 100644
--- a/docs/spfx/toolchain/migrate-gulptoolchain-hefttoolchain.md
+++ b/docs/spfx/toolchain/migrate-gulptoolchain-hefttoolchain.md
@@ -1,220 +1,68 @@
 ---
 title: Migrate from the Gulp-based to the Heft-based Toolchain
-description: In this article, you'll learn how to migrate an existing SharePoint Framework v1.21.1 project based on the legacy Gulp-based build toolchain to the Heft-based build toolchain introduced in SPFx v1.22.\*.
-ms.date: 12/30/2025
+description: Learn what changes when migrating a SharePoint Framework project from the Gulp-based build toolchain to the Heft-based build toolchain introduced in SPFx v1.22, and how to perform the migration using CLI for Microsoft 365.
+ms.date: 05/21/2026
 ms.localizationpriority: high
 ---
 # Migrate from the Gulp-based to the Heft-based Toolchain
 
-The migration steps in moving from a Gulp-based toolchain SharePoint Framework (SPFx) project to a Heft-based toolchain are more involved than a typical SPFx project upgrade from one version to another version.
-
-In this article, you'll walk through in detail all of the steps required for removing the Gulp toolchain from a SPFx version v1.21.1 project and adding the Heft-based toolchain as part of the upgrade to an SPFx v1.22.\* project.
+SPFx v1.22 introduced a new Heft-based build toolchain, replacing the Gulp-based toolchain used in SPFx v1.0–v1.21.1. This article explains what changes during the migration and how to perform it.
 
 > [!IMPORTANT]
-> **This article assumes that you are upgrading an existing SPFx v1.21.1 React web part project.**
->
-> The steps for upgrading other types of projects, such as those not using React, using SPFx extensions, or SPFx Adaptive Card Extensions instead of web parts are similar to the steps in this article.
+> This migration involves changes across more than 12 files including package removals, new package installations, configuration file replacements, new file creation, ESLint rule changes, and build script rewrites. Do not attempt to perform these changes manually — use the CLI for Microsoft 365 to generate the complete set of changes for your project.
 
 > [!TIP]
-> The steps in this page involve making numerous and significant changes to to your project. Before proceeding, strongly consider making a copy of your project or, if it's in source control, to start with a clean state (ie: no unstaged files).
-
-## Uninstall Gulp toolchain dependencies
-
-Start by first uninstalling the gulp-based toolchain packages from your project.
-
-```console
-npm uninstall @microsoft/sp-build-web ajv gulp
-```
-
-Next, uninstall the **@microsoft/rush-stack-compiler-\*** which maps to the current version of TypeScript that your project currently uses.
-
-For instance, the default SPFx v1.21.1 project uses TypeScript v5.3, so you would uninstall the **@microsoft/rush-stack-compiler-5.3** package:
-
-```console
-npm uninstall @microsoft/rush-stack-compiler-5.3
-```
-
-If you're using a different version of TypeScript, make sure that you uninstall the **@microsoft/rush-stack-compiler-\*** package with the TypeScript version in the name of the **@microsoft/rush-stack-compiler-\*** package.
-
-## Install Heft toolchain dependencies
-
-The next step is to install all of the dependencies the Heft-based toolchain requires:
-
-```console
-npm install @microsoft/spfx-web-build-rig@1.22.1 \
-            @microsoft/spfx-heft-plugins@1.22.1 \
-            @microsoft/eslint-config-spfx@1.22.1 \
-            @microsoft/eslint-plugin-spfx@1.22.1 \
-            @microsoft/sp-module-interfaces@1.22.1 \
-            @rushstack/eslint-config@4.5.2 \
-            @rushstack/heft@1.1.2 \
-            @types/heft-jest@1.0.2 \
-            @typescript-eslint/parser@8.46.2 \
-            --save-dev --save-exact --force
-```
-
-## Optionally upgrade TypeScript
-
-The Heft-based SPFx toolchain supports any version of TypeScript supported by the [Heft TypeScript Plugin](https://heft.rushstack.io/pages/plugins/typescript/) that toolchain is using.
-
-> [!TIP]
-> The **[loadTypeScriptTool.ts](https://github.com/microsoft/rushstack/blob/main/heft-plugins/heft-typescript-plugin/src/loadTypeScriptTool.ts)** file defines the TypeScript supported versions by the plugin. Ensure you are looking at the correct version of the plugin when considering the version of TypeScript to install.
-
-```console
-npm install typescript@~5.8.0 --save-dev
-```
-
-## Update the ESLint configuration
+> Use the [CLI for Microsoft 365 spfx project upgrade](https://pnp.github.io/cli-microsoft365/cmd/spfx/project/project-upgrade/) command to perform this migration automatically. It handles upgrades across any version gap — not just from v1.21.1 — by detecting your current version and generating the precise changes needed for your project. The report includes a single script to apply all changes in one go. See the [release notes](../release-1.22.2.md) for your target version for the specific command to run.
 
-Next, modify the default ESLint configuration for your project.
+[!INCLUDE [pnp-o365cli](../../../includes/snippets/open-source/pnp-o365cli.md)]
 
-Open the **./eslintrc.js** file and locate the following line:
+## What changes in this migration
 
-```javascript
-'@rushstack/hoist-jest-mock': 1,
-```
+The following areas of your project are affected when migrating from the Gulp-based toolchain to the Heft-based toolchain:
 
-Add the following immediately after that line:
+### Build toolchain packages
 
-```javascript
-// Require chunk names for dynamic imports in SPFx projects. https://www.npmjs.com/package/@rushstack/eslint-plugin
-'@rushstack/import-requires-chunk-name': 1,
-// Ensure that React components rendered with ReactDOM.render() are unmounted with ReactDOM.unmountComponentAtNode(). https://www.npmjs.com/package/@rushstack/eslint-plugin
-'@rushstack/pair-react-dom-render-unmount': 1,
-```
+The Gulp-based packages (`@microsoft/sp-build-web`, `ajv`, `gulp`, and `@microsoft/rush-stack-compiler-*`) are removed and replaced with Heft-based equivalents (`@microsoft/spfx-web-build-rig`, `@microsoft/spfx-heft-plugins`, `@rushstack/heft`, `@typescript-eslint/parser`, and `@types/heft-jest`).
 
-Then locate the following two rules and delete them:
+### TypeScript configuration
 
-```javascript
-'@microsoft/spfx/import-requires-chunk-name': 1,
+The existing `tsconfig.json` with its full `compilerOptions` block is replaced with a minimal file that extends the SPFx build rig's base TypeScript configuration. A new `config/typescript.json` file is added to configure static asset copying for the Heft TypeScript plugin.
 
-'@microsoft/spfx/pair-react-dom-render-unmount': 1
-```
+### Build scripts
 
-## Update npm scripts in package.json
+The `scripts` change from Gulp commands (`gulp bundle`, `gulp clean`, `gulp test`) to Heft commands (`heft build`, `heft clean`, `heft start`).
 
-Replace the existing `build`, `test`, and `clean` scripts in the **package.json** file with the following to use Heft instead of Gulp.
+### ESLint rules
 
-```json
-{
-  ..
-  "scripts": {
-    "build": "heft build --clean",
-    "clean": "heft clean",
-    "test": "heft test"
-  }
-  ..
-}
-```
+Two ESLint rules move from the `@microsoft/spfx/` namespace to the `@rushstack/` namespace: `import-requires-chunk-name` and `pair-react-dom-render-unmount`.
 
-### Optionally add additional scripts to package.json
-
-The project templates created for SPFx v1.22 include additional scripts to the **package.json** file. While these are optional, you can add them to your project's **package.json** to match the default projects:
-
-```json
-{
-  ..
-  "scripts": {
-    ..
-    "build": "heft test --clean --production && heft package-solution --production",
-    "start": "heft start --clean",
-    "clean": "heft clean",
-    "eject-webpack": "heft eject-webpack"
-  }
-  ..
-}
-```
+### Configuration files
 
-> [!TIP]
-> While not required, we recommend installing the Heft CLI globally:
->
-> ```console
-> npm install @rushstack/heft --global
-> ```
->
-> Once the Heft CLI is installed globally, you can run Heft commands without using the npm scripts.
+A new `config/rig.json` file is added to point the project at the `@microsoft/spfx-web-build-rig` shared configuration package. The existing `config/sass.json` is updated to use the Heft SASS plugin schema and extend the rig's default SASS configuration.
 
-## Add the SPFx Heft rig to the project
+### Removed files
 
-With the Heft toolchain now installed after removing the Gulp toolchain, the next step is to add a reference to the SPFx build rig. This is done by adding a new file to your project's configuration folder. That will reference the rig that the project will use.
+The `gulpfile.js` and `src/index.ts` files are removed as they are no longer needed by the Heft-based build system.
 
-Add a new file, **./config/rig.json**, to your project with the following contents:
+### Production dependencies
 
-```json
-{
-  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
-  "rigPackageName": "@microsoft/spfx-web-build-rig"
-}
-```
+All `@microsoft/sp-*` packages in `dependencies` are updated to the target SPFx version.
 
-## Replace the Sass configuration file
+## How to perform the migration
 
-Replace the entire contents of the existing **./config/sass.json** file with the following to use the Heft Sass configuration in the SPFx Heft rig. This is where you can modify the default settings on the [Heft Sass Plugin](https://heft.rushstack.io/pages/plugins/sass/):
-
-```json
-{
-  "$schema": "https://developer.microsoft.com/json-schemas/heft/v0/heft-sass-plugin.schema.json",
-  "extends": "@microsoft/spfx-web-build-rig/profiles/default/config/sass.json"
-}
-```
-
-## Add the Heft TypeScript Plugin configuration
-
-Add a new file, **./config/typescript.json**, to your project with the following code. This configures the [Heft TypeScript Plugin](https://heft.rushstack.io/pages/plugins/typescript/) used in the SPFx Heft rig:
-
-```json
-{
-  "extends": "@microsoft/spfx-web-build-rig/profiles/default/config/typescript.json",
-  "staticAssetsToCopy": {
-    "fileExtensions": [".resx", ".jpg", ".png", ".woff", ".eot", ".ttf", ".svg", ".gif"],
-    "includeGlobs": ["webparts/*/loc/*.js"]
-  }
-}
-```
-
-## Replace the TypeScript compiler configuration
-
-Replace the contents of the existing **./tsconfig.json** file with the following code. This assumes the same TypeScript configuration as the SPFx Heft rig's TypeScript configuration.
-
-```json
-{
-  "extends": "./node_modules/@microsoft/spfx-web-build-rig/profiles/default/tsconfig-base.json"
-}
-```
-
-## Delete gulpfile.js
-
-Delete the **./gulpfile.js** file from your project as it is no longer used.
-
-> [!TIP]
-> If you've made changes to your **gulpfile.js**, you may want to keep it until you've migrated those changes to the equivalent Heft extensibility options. Learn more about customizing the Heft-based toolchain: [Customizing the Heft-based build toolchain](customize-heft-toolchain-overview.md#customizing-the-heft-based-build-toolchain).
-
-## Upgrade production dependencies
-
-Finally, upgrade the production dependencies in the project to SPFx v1.22:
+Run the following command from the root of your project to generate a complete upgrade report:
 
 ```console
-npm install @microsoft/sp-component-base@1.22.1 \
-            @microsoft/sp-core-library@1.22.1 \
-            @microsoft/sp-lodash-subset@1.22.1 \
-            @microsoft/sp-office-ui-fabric-core@1.22.1 \
-            @microsoft/sp-property-pane@1.22.1 \
-            @microsoft/sp-webpart-base@1.22.1 \
-            --save-exact
+npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.2 --output md
 ```
 
-> [!TIP]
-> After making so many changes to the packages, consider deleting the **node_modules** and **./package-lock.json** (*or the equivalent lock file for the package manager you use*) and then re-running `npm install`. This ensures you will have a clean dependency tree.
+The report lists every required change and includes a consolidated script at the end that applies all changes in a single execution. Review the report, then run the script to complete the migration.
 
-## Test the project migration to the Heft-based toolchain
+## Verify the migration
 
-Test your changes by running the **build** command in the console from the root of your project.
+After applying the changes, verify the migration by running the build command:
 
 ```console
-# if you have heft installed globally...
-heft build --production
-
-# ... or you can run the npm helper script
 npm run build
 ```
 

From 1d581832cdc076425168b9cde39b00bd4c1d1404 Mon Sep 17 00:00:00 2001
From: Garry Trinder <garry@trinder365.co.uk>
Date: Mon, 29 Jun 2026 11:34:15 +0100
Subject: [PATCH 11/11] Fix absolute link in release-1.22.0

Replace absolute learn.microsoft.com URL with relative path and remove
pinned view parameter.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/spfx/release-1.22.0.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/spfx/release-1.22.0.md b/docs/spfx/release-1.22.0.md
index 12e1d1d32b..e0bb247047 100644
--- a/docs/spfx/release-1.22.0.md
+++ b/docs/spfx/release-1.22.0.md
@@ -9,7 +9,7 @@ ms.localizationpriority: high
 This release focused on updating and modernizing the SharePoint Framework (SPFx) build toolchain and to address all known 'npm audit' reported vulnerabilities in the Yeoman package and in the scaffolded projects.
 
 > [!NOTE]
-> [SharePoint Framework API Reference](https://learn.microsoft.com/javascript/api/overview/sharepoint?view=sp-typescript-latest) has been also updated to match the latest 1.22.0 version.
+> [SharePoint Framework API Reference](/javascript/api/overview/sharepoint) has been also updated to match the latest 1.22.0 version.
 
 **Released:** December 10, 2025