SharePoint Framework v1.22.1 release notes

This is a minor bump that fixes an issue where the a full screen error overlay was being displayed for runtime errors unrelated to third-party code.

Tip

It's safe to keep on using SharePoint Framework 1.22 version, but we do recommend using always the latest version in the production, which in this case would be the 1.22.1, which has fix on the reported GitHub issues as listed below.

Released: December 15, 2025

Important

This page addresses details related to a specific SPFx release version. This page doesn't include additional SPFx prerequisites that must be installed in order to develop SPFx solutions, including Node.js, Yeoman, and other tools.

To learn more about these prerequisites, see Set up your SharePoint Framework development environment.

Install the latest version

Install the latest release of the SharePoint Framework (SPFx) by including the @latest tag:

npm install @microsoft/generator-sharepoint@latest --global

Upgrading projects from v1.22 to v1.22.1

In the project's package.json file, identify all SPFx v1.22 packages. For each SPFx package:

1. Uninstall the existing v1.22 package:

   npm uninstall @microsoft/{spfx-package-name}@1.22
   

2. Install the new v1.22.1 package:

   npm install @microsoft/{spfx-package-name}@latest --save --save-exact
   

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.

Tip

To upgrade this project, run:

npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.1 --output md

This analyzes your project and outputs all required changes, including a single script to apply them in one go.

Note

The CLI for Microsoft 365 is an open-source solution with active community providing support for it. There is no SLA for the open-source tool support from Microsoft.

Fixed Issues

Here's a list of specific issues fixed around SharePoint Framework since the previous public release.

• #10525 - [SPFx 1.22.0] - Uncaught runtime errors