SharePoint Framework v1.21 release notes

Article
03/03/2025

This release has initial configuration updates for web parts in the context of flexible layouts in SharePoint and personalization option for cards. We're also looking to further include other technical updates before this version is generally available.

Caution

This version is currently available as a public beta made available for testing.

For production environments, we recommend using the SPFx version referenced on Set up your SharePoint Framework development environment.

beta.0 Released: February 25, 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 generally available release of the SharePoint Framework (SPFx) by using the @next tag

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

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

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

Uninstall the existing v1.20 package:

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

Install the new v1.21 preview package:

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

Tip

The CLI for Microsoft 365 provides an easy step-by-step guidance to upgrade your solutions to latest SharePoint Framework version.

New features and capabilities

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

Deprecations

No new updates.

Fixed Issues

No new updates.

Feedback and issues

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

Happy coding! Sharing is caring! 🧡

Share via