Transform classic pages to modern client-side 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 client side pages and this is the solution here. After you've maximized the use of the modern list and library user interface and connected your site to an Office 365 Group transforming the pages to modern client side pages is the last task to fully transform your classic site into a modern group connected site. Get inspired by the SharePoint Look Book as it allows you to discover the modern experiences you can build with SharePoint in Office 365.

The SharePoint PnP Modernization framework (Nuget, source code) 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.
  • The SharePoint PnP Modernization framework 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 sp-dev-modernization GitHub issue list.

Important

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 models and these models can used together:

Model Technique Audience Publishing Page support Keep/Discard option Comments
I want to transform pages for my users PowerShell DevOps Yes Optional (not for publishing pages) Typically used when you want to modernize pages for multiple site collections. Optionally you can configure the page accept banner to be shown which then enables your end users to keep or discard the pages you've created using PowerShell
I want to have full control on the page transformation process .Net DevOps Yes Optional (not for publishing pages) Typically used when you integrate page transformation into existing services or tools. Optionally you can configure the page accept banner to be shown which then enables your end users to keep or discard the pages you've created using .Net. 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.
Empower my users to transform pages (beta) SharePoint Page Transformation UI End user No Mandatory This component is in beta release...using PowerShell or .Net is currently the preferred approach for doing page transformation. If you want your end users to have the ability to self-service modernize pages. This approach will make it possible for end users to simply click a button to request a modern version of a page. The returned page is a preview and the end user will have the option to keep or discard the generated page.

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 (as of November 2019 release) x x x x
Publishing page x x x x x

See also