Skip to content

release-1.21.md

Latest commit

 

History

History
118 lines (74 loc) · 4.22 KB

release-1.21.md

File metadata and controls

118 lines (74 loc) · 4.22 KB
title SharePoint Framework v1.21 release notes
description Release notes for the SharePoint Framework v1.21 release.
ms.date 01/20/2026
ms.localizationpriority high

SharePoint Framework v1.21 release notes

This release has updates on the Node.js version and on other technical dependencies. It also contains updates for web parts in the context of flexible layouts in SharePoint and a personalization option for cards.

Note

SharePoint Framework API Reference has also been updated to match the latest 1.21 version.

Released: April 23, 2025

[!INCLUDE spfx-release-notes-common]

Install the latest version

Install the latest generally available release of the SharePoint Framework (SPFx) by using the @latest tag

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

Upgrading projects from the SPFx v1.20 to v1.21 version

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

  1. Uninstall the existing v1.20 package:

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

  2. Install the new v1.21 package:

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

[!INCLUDE spfx-release-upgrade-tip]

New features and capabilities

Node.js v22 support

Node.js support has been updated to v22 with the v1.21 release.

Note

Notice that Node.js v22 is the only supported version, with v1.21.

TypeScript 5.x support

TypeScript has been updated to TypeScript v5.x. Default scaffolded projects are using currently specifically v5.3.3 version by default.

Flexible layout configuration options for web parts

New flexible layout sizing options are introduced for the web part manifest. These can be used to adjust the default behavior for the custom web parts as they're used within flexible layouts.

  "flexibleLayoutSizing": {
    "supportsDynamicResizing": true,
    "defaultRowHeight": 10,
    "defaultColumnWidth": 10
  }

Note

By default, all custom web parts are supported in the flexible layout option and don't require any code-level changes.

Flexible layout support

Viva Connections card personalization support

Viva Connections will start supporting end user configuration options for the dashboard. End users can add and remove cards from the dashboard based on their preference. Supported cards are explicitly enabled for this scenario, and custom cards are supported.

By default, personalization isn't allowed for the custom Viva Connections cards.

  "personalization": "Disallow"

Card personalization visible in the dashboard UI

Updating Teams JS SDK

Default Teams JavaScript SDK version for the SPFx-powered solutions has been updated to version 2.32.

Changes

The default debugging URL location was changed as part of the release. debugManifestsFile is updated as https://localhost:4321/temp/build/manifests.js. This might have an impact on any tooling or scripts that have previously taken a dependency on this URL. Please update those accordingly with this change.

Previous versions

[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/manifests.js

Updated debugManifestFile URL starting from 1.21 version

[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/build/manifests.js

Deprecations

No new updates.

Fixed Issues

No new updates.

Feedback and issues

We're interested in your feedback about the release. Do let us know any findings or other feedback using the SPFx issue list.

We will be doing some cleaning in the issue list after the 1.21 release to better focus on the latest issues and are more focused on helping you with any of your findings.

Happy coding! Sharing is caring! 🧡