Transform classic pages to modern pages

Classic SharePoint sites typically have classic pages being wiki pages, web part pages, blog pages or publishing pages and these pages cannot present themselves using a modern user interface. A classic site however can host modern pages which enable great end user experiences. You can find inspiration via the SharePoint Look Book as it allows you to discover the modern experiences you can build with SharePoint in Office 365.

SharePoint PnP Modernization is part of the PnP Framework library (source code) and does bring page transformation capabilities which will be explained in the upcoming chapters.

Important

  • Page transformation today works for wiki pages, web part pages, blog pages and publishing pages.
  • SharePoint PnP Modernization is part of the PnP Framework and is continuously evolving, checkout the release notes to stay up to date on the latest changes. If you encounter problems please file an issue in the PnP Framework GitHub issue list.
  • Modernization tooling and all other PnP components are open-source tools backed by an active community providing support for them. There is no SLA for open-source tool support from official Microsoft support channels.

Page transformation can be used in one or more of the below models:

Model Technique Audience Publishing Page support Comments
I want to transform pages for my users PowerShell DevOps Yes Typically used when you want to modernize pages for multiple site collections. Using PowerShell is the easiest and recommended approach.
I want to have full control on the page transformation process .Net DevOps Yes Typically used when you integrate page transformation into existing services or tools. The core of page transformation is the .Net based SharePoint PnP Modernization framework. Using .Net you can fully tailor the transformation process, this approach is recommended whenever you want full control on the transformation process or when you want to integrate page transformation into another solution/product.

Page transformation supports a wide range of SharePoint versions and page types as source, all of these result in modern pages in SharePoint Online as a result. Below table shows the possible page types versus pages sources that can be transformed to modern pages using the latest page transformation release.

Page Type SharePoint 2010 SharePoint 2013 SharePoint 2016 SharePoint 2019 SharePoint Online
Wiki page x x x x x
Webpart page x x x x x
Blog page x x x x x
Publishing page x x x x x

Note

To transform SharePoint 2010 pages you need to use our legacy versions: SharePointPnPPowerShellOnline / PnP Modernization Framework.

See also