Area: Optimizely CMS
Applies to versions: 10 and higher
Other versions:

Creating a page programmatically

Recommended reading 
Note: This documentation is for the preview version of the upcoming release of CMS 12/Commerce 14/Search & Navigation 14. Features included here might not be complete, and might be changed before becoming available in the public release. This documentation is provided for evaluation purposes only.

The following examples show how to create a page programmatically in Optimizely CMS and set the MainBody property.

  1. Decide where you want your new page published in the structure of the website by specifying a ContentReference object pointing to the desired parent page, such as the start page as in the following code:
    var parent = ContentReference.StartPage;
  2. Create a new empty page with default values, according to the property settings of its page type, by specifying the parent under which to create the page and by specifying the page type:
    IContentRepository contentRepository = EPiServer.ServiceLocation.ServiceLocator.Current.GetInstance<IContentRepository>();
    PageData myPage = contentRepository.GetDefault<StandardPage>(parent);
  3. After you created an empty page under the specified parent page programmatically, specify page property values before you publish the page, as shown in the following example:
    myPage.PageName = "My new page";

    The code example below shows how to define the user defined property MainBody:

    myPage.MainBody = "<p>This is produced programmatically.</p>";

    The following case shows how to assign a content property when a typed model is not known:

    myPage.Property["MainBody"].Value = "<p>This is produced programmatically.</p>";
  4. Publish the newly created page by calling the Save method of the DataFactory class:
    contentRepository.Save(myPage, EPiServer.DataAccess.SaveAction.Publish);

    Note: The method call requires that the current user has the proper permissions to publish a page in this location. This causes a problem if the current user is an anonymous user and you still want the page to be published programmatically. You can use another overload of the Save method to permit the publishing, even if the current user does not have the necessary permissions:

    contentRepository.Save(myPage, EPiServer.DataAccess.SaveAction.Publish, EPiServer.Security.AccessLevel.NoAccess);
Do you find this information helpful? Please log in to provide feedback.

Last updated: Jul 02, 2021

Recommended reading