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 1/9] 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 2/9] 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 3/9] 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 4/9] 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 5/9] 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 6/9] 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 7/9] 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 8/9] 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 9/9] 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