SharePoint Framework domain isolated web parts retirement

Message Information

Severity normal Major Change
Timeline
Start Date May 13, 2024
End Date May 4, 2026
Last Modified May 13, 2024
Services
SharePoint Online
CategoryPlanForChange

Message Details

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: