Assess and transform classic SharePoint pages

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.

Page modernization workflow

1. Configure and run the Classic pages assessment.
2. Validate site, web, and Audit coverage.
3. Interpret and prioritize the page results.
4. Remediate or map blocking Web Parts.
5. Transform selected pages with PnP PowerShell.
6. 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

1. Review the Classic pages assessment requirements.
2. Run the Classic pages assessment.
3. Interpret and prioritize the page results.
4. Review publishing-page readiness, when applicable.
5. Transform selected pages with PnP PowerShell.
6. Validate the transformed pages.

Reference

• Classic pages assessment CSV reference
• Common assessment CSV reference
• Page transformation guidance