Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Content types

Explains the content types used in CMS (SaaS) and how to create and edit them.

🚧

Important

This section is for CMS administrators and developers with administrator access rights and applies to the SaaS version of the CMS user interface.

Content types are structured models of content. They can be simple or complex. For example:

  • You can have a simple Title content type that consists of a single text field.
  • You can create something more complex like an Address content type that has a text field for the street, city, and state and a number field for the zip code. See Content modeling for an overview. See also a demonstration of Visual Builder content types.

The content type is the foundation for creating one to many page, block, media, and experience instances. You must map the content type and its properties to the corresponding rendering to display content to visitors.

Go to Settings > Content Types to see a list of existing content types and to create them.

The main structure models for content types are Page, Block, Media, and Experience. Media types are items such as Images, Video, and other Media content. To create a content type, go to Settings > Content Types > Create New > {select the content type you want}.

You can customize content types into specific models for your purposes, such as Article, Article List, Call to Action, Card, and more by defining each model's properties. Each type contains properties where editors enter information. To modify an existing content type's properties, go to Settings > Content Types > {select content type} > Properties.

Properties can hold information, such as a link to an image, a page, or editorial text. A typical application has a set of content types that match the identified functions needed on that application.

Page type

A page type is content that you can display with a template and unique URL, used to represent a webpage on your application. You can have multiple webpages using the same page type, but each webpage must be a page type. The following list shows typical uses of the page type:

  • A template for a page where the layout is defined and you fill in content, such as a search result page or a product listing page.
  • A container page where there is no set layout, and you can modify the layout and content, such as a special campaign page or terms and conditions page.
  • A mix of template and container where there is some set layout defined, but you have some freedom for certain layouts or structures such as a homepage with predefined areas for content, but you can change two, three, or four columns in certain areas.

Edit a page type

To edit settings for an existing page type, perform the following steps. See Define page properties for details about page settings.

  1. Go to Settings > Content Types.

  2. Select the page type from the list.

  3. Click Settings.

  4. Modify the form.

  5. Click Save.

Create a page type from the Settings view

  1. Go to Settings > Content Types, and select Create New > Page Type.

  2. Set values in the new page Settings tab.

    • Name (required) – Enter a name for the page type.
    • Display name – Enter the name to be displayed in the list of available page types.
    • Description – Enter the text describing the page type also displays in the list of available page types.
    • Sort index – Enter a number to determine the (ascending) sort order for content types listed on the Content Types page.
    • Available in edit view – Select to make the page type available when creating pages in the editorial interface. You should hide rarely used page types, such as the start page type. You can make these available when needed and then hide them again.
  3. Set the values on the Permissions tab.

    You can use the Search box to filter and find users and groups to which you want to give access.

  4. Set values on the Default Values tab for some of the built-in properties.

  5. Set values on the Child Content Types tab.

    When creating pages, limit the available page types in the page type list to make it easier for editors to choose the correct page type. For example, for a Bank Deposits parent page, you can specify that the only available page type is a Bank Deposits page and not on others.

  6. Click Save.

Copy an existing page type

Copying a page type also copies its properties. You can then edit the information for the page type and its properties. Copy a page type as follows:

  1. Select Copy Page Type in the Manage Page Types tab in the Settings view.
  2. Select the page type you want to copy from the drop-down list and click Copy. A window displays the same properties.
  3. Edit the page type information to suit your requirements and click Save.

📘

Note

Copied page types are untyped, and you need to add the path to the display template; otherwise, pages based on the page type do not have a preview.

Block type

A block type is a component or module that makes up a portion of a web page. It is reusable content you can display with a template; it does not have a URL. It can consist of other block types, content, and media types. You can create block types to do the following (and more):

  • A carousel container, used for holding multiple slides
  • A slide used in a carousel
  • A button
  • A navigation menu
  • SEO settings for a page
  • Label dictionary for the application
  • An interactive map

Block types are similar to page types, and you can modify some settings from the Settings view. See also Define page properties.

Edit a block type

  1. Go to Settings > Content Types, and select a block type (such as Card Component).

  2. Click Settings.

    • Name (required) – Enter a name for the page type.

    • Display name – Enter the name to be displayed in the list of available page types.

    • Description – Enter the text describing the page type also displays in the list of available page types.

    • Sort index – Enter a number to determine the (ascending) sort order for content types listed on the Content Types page.

    • Available in edit view – Select to make the page type available when creating pages in the editorial interface. You should hide rarely used page types, such as the start page type. You can make these available when needed and then hide them again.

    • Available for composition in Visual Builder – Select to let this block work in Visual Builder.

      • Element – Select to display this block as an element in Visual Builder. Selecting Element affects the available options for adding properties to the block.
      • Section – Select to display this block as a section in Visual Builder.
  3. Select Properties and specify the components of your element type. For example, the Card Component content type has a Heading property, which is further defined in Configure Property.

  4. You can modify Permissions and other properties, similar to changes to page types.

  5. Click Save to define the Card Component content type.

Block as an element

If you selected a block (such as Card Component) to display in Visual Builder as an element, when you click Add Element in a Visual Builder Outline, Card Component is listed among the selections.

The following image shows a partial view of Card Component when it is added as an element of a section:

Block as a section

If you selected a block (such as Card Component) to display in Visual Builder as a section, when you click Add Section in a Visual Builder Outline, Card Component is among the selections.

Selecting it creates a New Card Component section in the outline.

The following image shows a partial view of Card Component as a section:

Media type

Media types are any file you want to load into CMS (SaaS). You can add properties, modify permissions, and edit some settings from the Settings view. The following list shows media types:

  • Image – .jpg, .png, .webp, .svg, .gif, .tiff, and so on.
  • Video – .mp4, .avi, .mov, .wmv, .webm, .mkv, .ogg, and so on.
  • Media – Everything else such as .pdf, .docx, .mp3, .zip, .iso, .ttf, .js, .css, and so on.

Edit a media type

Edit the settings for an existing media type as follows:

  1. Go to Settings > Content Types, and select a media type (Image, Video, or Media).
  2. Click Settings.
  3. Enter the following information.
    • Name – A name for the media type.
    • Display name – The name to be displayed in the list of available media types.
    • Description – The text describing the media type also displays in the list of available media types.
    • Sort index – A number determining the (ascending) sort order in the list of available media types. The default is 0.
  4. Click Save.

Create a media type from the Settings view

  1. Go to Settings > Content Types, and select Create New > Media Type.

  2. Enter the following information.

    • Name (required) – A name for the media type.

    • Display name – The name to be displayed in the list of available media types.

    • Description – The text describing the media type also displays in the list of available media types.

    • Sort index – A number determining the (ascending) sort order in the list of available media types. The default is 100.

    • Type – Required for image and video types. Select the media type.

    • Supported media extensions – Comma-separated list of file extensions the media type supports.

  3. Click Save.

Experience type

An experience type is an extension of the page type, enhanced to be used with Visual Builder. Because it is managed by Optimizely, you cannot adjust the Settings, but you can modify Permissions and other properties, similar to changes to page types described in Create a page type from the Settings view.  

For example, the Blank Experience content type has a single property called SEO Settings, which is a Block property with the specifications of the Page SEO Setting block Type.

Section type

You cannot create a section type in the Create New dropdown list like when you create other content types, but CMS (SaaS) provides it by default to help organize your content in an experience type in the Visual Builder.

You cannot adjust a section type, but you can modify Permissions and other properties.

Other content types

By default, there are generic content types for other types of content, such as folders and media files. Based on these, you can create specific content types. You can have a specific folder or media file content type where you can add properties such as Copyright or Photographer.