{"id":20705,"date":"2024-05-13T08:14:41","date_gmt":"2024-05-13T15:14:41","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=20705"},"modified":"2024-05-13T08:53:10","modified_gmt":"2024-05-13T15:53:10","slug":"retiring-sharepoint-framework-domain-isolated-web-parts-for-sharepoint-online","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/retiring-sharepoint-framework-domain-isolated-web-parts-for-sharepoint-online\/","title":{"rendered":"Retiring SharePoint Framework domain isolated web parts for SharePoint Online"},"content":{"rendered":"<p>After careful consideration and extensive review of usage data and feedback we\u2019ve decided to announce the retirement of the domain isolated web parts feature in SharePoint Framework (SPFx). As of April 2, 2026 domain isolated web parts will be fully retired and stop working for existing tenants. If tenants are still using domain isolated web parts then they\u2019ll see the web part render and error message and stop functioning. New tenants onboarding from April 2, 2025 will not be able to use domain isolated web parts. This applies to all environments including Government Clouds and Department of Defense. There will not be an option to extend domain isolated web parts beyond April 2, 2026.<\/p>\n<p>We apologize for any inconvenience this may cause, but we believe this is the best decision for the future of SPFx and SharePoint.<\/p>\n<h2>Timeline<\/h2>\n<table style=\"width: 91.182%; height: 104px;\">\n<tbody>\n<tr style=\"height: 30px;\">\n<td style=\"width: 19.5616%; height: 30px;\">Date<\/td>\n<td style=\"width: 86.1621%; height: 30px;\">Action<\/td>\n<\/tr>\n<tr style=\"height: 44px;\">\n<td style=\"width: 19.5616%; height: 44px;\">April 2, 2025<\/td>\n<td style=\"width: 86.1621%; height: 44px;\">Domain isolated web parts will be turned off for newly created tenants.<\/td>\n<\/tr>\n<tr style=\"height: 30px;\">\n<td style=\"width: 19.5616%; height: 30px;\">April 2, 2026<\/td>\n<td style=\"width: 86.1621%; height: 30px;\">Domain isolated web parts will be turned off for existing tenants.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Overview<\/h2>\n<p>Domain isolated web parts allow developers to create web parts that run in a separate domain from the host page, providing an additional layer of security and isolation. Due to the performance implications of running in dedicated domain we saw limited usage of this feature.<\/p>\n<p>To understand whether you have installed domain isolated web parts and granted permissions you can verify if the <a href=\"https:\/\/learn.microsoft.com\/sharepoint\/api-access\">SharePoint admin center API access page<\/a> contains permissions listed under the \u201cIsolated\u201d grouping.<\/p>\n<p><img decoding=\"async\" width=\"1632\" height=\"939\" class=\"wp-image-20713 alignnone\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5.png\" alt=\"A screenshot of a computer Description automatically generated\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5.png 1632w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5-300x173.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5-1024x589.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5-768x442.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/04\/a-screenshot-of-a-computer-description-automatica-5-1536x884.png 1536w\" sizes=\"(max-width: 1632px) 100vw, 1632px\" \/><\/p>\n<p>If you see permissions listed under \u201cIsolated\u201d then follow the steps described in the <a href=\"https:\/\/aka.ms\/retirement\/domainisolatedwebparts\/support\">domain isolated web part retirement documentation<\/a> to understand more about the deployed domain isolated web parts. This script will create two CSV files:<\/p>\n<ul>\n<li>Solutions.csv: this file contains an overview of the solutions that contain domain isolated web parts<\/li>\n<li>Pages.csv: this file contains an entry per page holding one of the domain isolated web parts<\/li>\n<\/ul>\n<h2>Call to Action guidance<\/h2>\n<p>If you are using domain isolated web parts in your SPFx solutions, you will need to migrate them to regular web parts before April 2026. Otherwise, your web parts will stop working after that date. Microsoft is working on to be announced features that offer an alternative strategy for domain isolated web parts, but we strongly recommend to move away from domain isolated web parts.<\/p>\n<p>To migrate your web parts, you will need to switch the &#8220;isDomainIsolated&#8221; property from the package-solution.json file to false, increment the version and redeploy your solution. Next to that you also need to ensure that the permissions granted to the domain isolated web part, listed under the \u201cIsolated\u201d grouping in the API access page of SharePoint admin center, are now granted as \u201cOrganization-wide\u201d permissions. Check the <a href=\"https:\/\/learn.microsoft.com\/sharepoint\/api-access?WT.mc_id=365AdminCSH_spo\">Manage access to Microsoft Entra ID-secured APIs<\/a> article to learn more.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Announcing the retirement of the domain isolated web parts feature in SharePoint Framework (SPFx).<\/p>\n","protected":false},"author":103259,"featured_media":21221,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[166,9],"tags":[214],"class_list":["post-20705","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sharepoint","category-sharepoint-framework","tag-sharepoint-online"],"acf":[],"blog_post_summary":"<p>Announcing the retirement of the domain isolated web parts feature in SharePoint Framework (SPFx).<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/20705","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/103259"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=20705"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/20705\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/21221"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=20705"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=20705"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=20705"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}