MC792601 - SharePoint Framework domain isolated web parts retirement

Service

SharePoint Online

Published

May 13, 2024

Tag

Major change
User impact
Admin impact
Retirement

Summary

Microsoft is retiring SharePoint Framework domain isolated web parts. Starting April 2, 2025, new tenants won't have this feature, and it will be removed for existing tenants on April 2, 2026. Organizations should update and redeploy affected web parts as regular web parts.

More information

After careful consideration and extensive review of usage data and feedback Microsoft has decided to retire the domain isolated web parts feature in the SharePoint Framework (SPFx).

When will this happen:

  • Starting April 2, 2025, domain isolated web parts will be turned off for any newly created tenants.
  • Starting April 2, 2026, Microsoft will remove the ability to use domain isolated web parts for existing tenants.

How this will affect your organization:

If your organization still uses domain isolated web parts, after the change has rolled out these will render an error message and stop functioning. We recommend customers to update the impacted web parts as regular web parts and redeploy them.

What you need to do to prepare:

To understand whether you have installed domain isolated web parts and granted permissions you can verify if the SharePoint admin center API access page contains permissions listed under the Isolated grouping. If you see permissions listed under Isolated then you can use the instructions described on the domain isolated web part retirement page to discover the solutions, their domain isolated web parts and where those web parts are used. This resource will also contain the needed steps to update the web parts to not use domain isolation.

Note: There will not be an option to extend domain isolated web parts beyond April 2, 2026.

Learn more: