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 Schema | Nested Region name | Component Presentations |
|---|---|---|
| Content Page | Main | All Component Presentations |
| Content Page Without Navigation | Main | All Component Presentations |
| Home Page | Hero | Homepage List |
| Article | Homepage Welcome | |
| Further Info | All other Component Presentations | |
| Include Page | Main | All Component Presentations |
| Include Page (Footer) | Links | Footer |
| Footer Links | All other Component Presentations | |
| Include Page (Header) | Logo | Header |
| Nav | Header Links | |
| Language Selector Configuration | ||
| Navigation Configuration | ||
| Info | Old Browser bar | |
| Cookie bar | ||
| Include Page (Left) | Left | Navigation Configuration |
| Include Page (Tools) | Tools | Navigation Configuration |
| Social Sharing Links | ||
| News Page | Article | Article |
| Redirect Page | none | none |
| Section Page | Main Section | Article |
| Further Info | All other Component Presentations |