This content is archived. See latest version here.

Last updated: Mar 25 2013

Introduction

The "convert pages" function makes it possible to convert existing pages from one page type to another. During this operation the user selects how properties should be mapped from the existing page type to the new page type.

Using Page Type Conversion in EPiServer CMS

You can find the "convert pages" function in EPiServer CMS Admin mode under the Page Type tab > Convert Pages. It is possible to convert a single page or all pages (of specified page type) below a given page. After selecting the scope, you select which page type you want to convert from and to. Below the page type selection there is a property map table where properties from the page type to convert from and to are listed. Select which property on the new page type to map to for each property in the table.

Language Handling

If a property is language-specific on the page type to convert from but is not language-specific on the page type to convert to, then the property value for the master language will be set on the converted page.

If a property is not language-specific on the page type to convert from but is language-specific on the page type to convert to, then the property value will be set for each language version of the converted page.

Test Conversion

It is possible to do a test conversion before doing the actual conversion. This can be useful to get information, for example, how many pages that will be affected.

Irreversibility

The page conversion is an irreversible process, which means content in the database can be removed permanently. It is recommended that a test conversion is run before the actual conversion to see that no undesirable action will take place. It is also advisable to do a database backup before performing the conversation giving you the option of returning to the unconverted state.

Mirroring

If a page that is part of a mirroring channel is converted, property changes will still be mirrored for properties that do not have a changed name. The page type for pages at the destination will not change due to the conversion. In order for the page type conversion to be done at a destination you either have to manually perform an identical covert operation for the mirrored pages on the destination or reset the channel and remove the affected pages from the destination.

Comments