Migrating Tridion Sites Pages to the schema-based Region model

If you have existing Page designs in Tridion Sites, where regions are defined in the Component Template, you can migrate them to the newer Page designs with schema-based regions by modifying the Page Templates in the Content Manager.

About this task

Tridion Sites 9 introduced enhancements where Regions can be defined on the Page Schema so that the Page and these Regions can be further designated as containers for additional nested Regions or for Component Presentations. Prior releases of DXA have supported Regions differently though Component Template design. These template-based Regions are still possible and supported for customers who are running SDL Web 8 and wish to upgrade to DXA 2.1 (or later). It is also technically possible to use the template-based regions with Tridion Sites 9; however, we strongly discourage this except for temporary migration purposes.

With schema-based Regions, a the Page Schema divides the Page into Regions, and each of these Regions may also be divided further into nested Regions. Typically, a Region renders as a specific area of the published webpage, such as a header, footer, content area or navigation area. Migration of existing content to schema-based Regions can differ significantly based on individual implementation. For general guidance on migrating to the new design, refer to the Tridion Sites documentation.

The following table provides general guidance for migrating legacy template-based Regions in DXA content to the Regions now defined in the Page Schema:

Page SchemaNested Region nameComponent Presentations
Content PageMainAll Component Presentations
Content Page Without NavigationMainAll Component Presentations
Home PageHeroHomepage List
ArticleHomepage Welcome
Further InfoAll other Component Presentations
Include PageMainAll Component Presentations
Include Page (Footer)LinksFooter
Footer LinksAll other Component Presentations
Include Page (Header)LogoHeader
NavHeader Links
Language Selector Configuration
Navigation Configuration
InfoOld Browser bar
Cookie bar
Include Page (Left)LeftNavigation Configuration
Include Page (Tools)ToolsNavigation Configuration
Social Sharing Links
News PageArticleArticle
Redirect Pagenonenone
Section PageMain SectionArticle
Further InfoAll other Component Presentations