Microsoft announced retirement for SharePoint Add-Ins and ASC-based app permissions (SharePoint app-only principals). Let me summarize here:
- SharePoint Add-Ins, ASC-based app permissions and SharePoint app-only principals
- Timeline of retirement and future plans
- How to detect if there are legacy service principals used in the environment
- Migration guidance
Timeline
Known key retirement milestone dates:
- Mar 2024 – Microsoft will stop accepting new Add-In submission to app store
- Jul 2024 – Microsoft will stop ability for customers to acquire add-ins from App Store (*)
- using ACS and Add-ins will be blocked for new tenants since Nov 2024 (**)
- using ACS and Add-ins will be blocked for all existing tenants since Apr 2, 2026
(*) SPFx based solutions will continue to be available, Installation from a private app catalog stays possible
(**) regardless of their origin (public marketplace, private tenant catalog)
So timeline is generous, and we have plenty of time to
What you need to do to prepare
- Detect if there are any legacy service principals used in the environment:
Use the Microsoft 365 Assessment tool (by PnP) to scan your tenants for SharePoint Add-In usage. - Migrate existing solutions that use Add-Ins or SP App-only spns – Review the guidance for migrating from SharePoint Add-Ins to SharePoint Framework.
- Disable SharePoint Add-Ins on your tenant using SharePoint Online Management Shell
How to disable SharePoint Add-Ins on your tenant
Admins can disable SharePoint Add-Ins with the Set-SPOTenant SharePoint Management Shell PowerShell command.
Connect-SPOService -Url https://<tenant>-admin.sharepoint.com
Set-SPOTenant -IsSharePointAddInsDisabled $true
After SharePoint Add-Ins are disabled, users will not be able to add SharePoint Add-Ins to their sites, and admins cannot add new SharePoint Add-Ins to the tenant and site collection app catalogs. SharePoint Add-Ins already added to sites will stay available and can still be used by the site’s users.
SharePoint Add-Ins will not be available from the public marketplace
After July 1, 2024, users browsing the public marketplace (AppSource) will see SharePoint Add-In, but if they select Get it now, a message will explain that SharePoint Add-Ins are retired and cannot be added. If you still require a specific SharePoint Add-In, contact the Add-In creator to understand the possible options.
Resources
- Microsoft: SharePoint Add-In retirement in Microsoft 365
- (Updated June 13, 2024) SharePoint Add-In retirement in Microsoft 365 MC693865
- Microsoft: Microsoft 365 Assessment tool (by PnP)