Kentico Xperience 13 documentation and ASP.NET Core

Most documentation about running Xperience applications under ASP.NET Core can be found in a dedicated section: Developing Xperience applications using ASP.NET Core. The rest of the documentation still applies, but some code samples and scenarios might need slight modifications for Core projects.

All major differences between the MVC 5 and Core platforms are summarized in Migrating to ASP.NET Core.


Creating page types

This page describes how to create page types in the Page types application.

Creating page types

  1. Open the Page types application.
  2. Click New page type.

The New page type wizard opens. Your choices throughout the wizard determine the functionality and purpose of the given pages. The resulting pages may represent actual pages available on the live site, only serve as data containers used by other pages, or simply provide folders for organizing and categorizing the website content tree.

Step 1 – Names

  1. Fill in the following values:
    • Page type display name – the system displays this name to users in the administration interface
    • Namespace – the namespace is a prefix that distinguishes between page types. For example, it can be used to separate page types created for different sites, identify page types imported as part of third-party modules, etc.
    • Name – a unique page type identifier, which is appended to the namespace.


      When creating page types, always use a unique namespace.

      Never use the cms, com, om or content prefixes. A recommended option is to use your company name or an abbreviation as the prefix, for example: ACME_MyPageType.

  2. Click Next.

Filling in the page type names

Step 2 – Features

Select the features that you want to enable for the page type, depending on the intended purpose of the given pages:

  • Page builder – allows editors to manage page content through a user-friendly interface, using configurable widgets and page templates prepared by developers. The page builder feature must also be enabled in the code of the MVC live site application. For more information, see Page builder development. Enabling this feature also enables the URL feature – it is not possible to edit page builder pages without the page being accessible in some form.
  • URL – allows pages to have URLs configurable depending on the selected routing mode. This feature also controls the visibility of the Alternative URLs editing interface, if enabled for the site.
  • Metadata – allows editors to enter metadata for pages. Metadata present details about the content of your pages, which can be used directly as part of your website (e.g. title) or when implementing search engine optimizations. The metadata include page title, description, and keywords. For more information, see Editing metadata of pages and Displaying page content.
  • Navigation item – allows content editors to control which pages appear in the website's navigation menus. For more information, see Building website navigation.

All pages based on this page type will have the selected features.

Click Next.

Selecting features for a new page type

Step 3 – Database information

  1. Choose whether the page type will contain custom fields and have a dedicated database table.

    The remainder of this page describes page types with custom fields.

    To create a page type without custom fields, click the Skip this step and continue without custom fields link in the wizard footer. To learn more about such page types, switch to the Creating page types without fields page.

  2. Enter a Table name for the database table that stores the data of the page type's fields.
  3. Enter a Primary key name for the table.
  4. (Optional) Select if you want the page to Inherit fields from page type (reuse the field structure of an existing page type).

  5. Click Next.

The system creates the database table.

Filling in the database information for a page type

Step 4 – Fields

Now, you need to define the page type's data fields (columns of the table):

  1. Click New field.
  2. Define the custom field using the field editor.

  3. Click Save.

  4. Repeat the steps above for all required fields.

  5. Click Next after you have prepared all necessary fields for the page type.

You can also make system page fields editable on the Content tab of the Pages application for pages of the given type. To do this, create a new field and select Page field in the Field type drop-down list. You can then choose from the following two groups of system fields:

  • Page fields – general page fields that have separate values for each language version of the page.
  • Node fields – general page fields that are shared by the entire content tree node (all language versions of the page).

Page or node system fields are then offered in the Field name drop-down list.

Creating fields for the page type

Step 5 – Parent types

Select the parent page types under which pages of the new type will be allowed in the website content tree (when managing pages in the Pages application).

  1. Click Add page types and select specific page types.
  2. Click OK.
  3. Click Next.

Adding parent page types

Step 6

The wizard has finished the configuration of the new page type.

Click Finish. You have created a new page type. 

How content in page types is stored

The new page type has its own database table for its specific fields. The overall data of pages is stored in three tables:

  • CMS_Tree (content tree structure)
  • CMS_Document (general page properties, metadata and page builder content defined on the Page tab)
  • The dedicated page type table, e.g. custom_Article (the page type fields)

For detailed information, see: Page database structure

Further configuration

After creating a new page type, you may want to continue with the following optional configuration:

Was this page helpful?