Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Use the Microsoft 365 Assessment tool to discover classic pages and understand their page-transformation readiness. Then use the assessment results to prioritize remediation and transform selected pages with PnP PowerShell.
This guidance focuses only on classic page assessment and its handoff to page transformation.
Important
Classic user-created pages are being deprecated in SharePoint Online. Beginning March 1, 2027, creation of classic pages will be disabled for new tenants, and beginning October 1, 2028, existing classic user-created pages will become read-only for all tenants. Existing classic page content isn't deleted and remains available for viewing. We recommend planning your transition to modern SharePoint page experiences. For details, timelines, and modernization guidance, see Upcoming changes to classic publishing sites, classic pages, and custom scripting in SharePoint Online.
Page modernization workflow
- Configure and run the Classic pages assessment.
- Validate site, web, and Audit coverage.
- Interpret and prioritize the page results.
- Remediate or map blocking Web Parts.
- Transform selected pages with PnP PowerShell.
- Validate the modern pages and expand the migration wave.
Use assessment output for transformation
| Assessment output | Transformation decision |
|---|---|
PageUrl, PageType, Layout |
Identify the source page and transformation path. |
HomePage, UncustomizedHomePage |
Select home pages and simple early migration waves. |
MappingPercentage, UnmappedWebParts |
Find pages that need Web Part remediation or mapping changes. |
classicpagewebparts.csv |
Review the exact Web Part type, position, visibility, and mapping result. |
ModifiedAt, classicpageauditusage.csv |
Prioritize active content and avoid transforming unused pages without a business need. |
classicpublishingsitesummaries.csv |
Size publishing-page work and identify used layouts. |
Mapping readiness is an input to planning, not a guarantee that the transformed page will preserve every visual or business behavior.
Next steps
- Review the Classic pages assessment requirements.
- Run the Classic pages assessment.
- Interpret and prioritize the page results.
- Review publishing-page readiness, when applicable.
- Transform selected pages with PnP PowerShell.
- Validate the transformed pages.