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

On-page edit

Edit pages and shared blocks directly in Optimizely CMS 13 using on-page editing. Update content, manage properties, and publish drafts with ease.

📘

Note

If you also want the On-page edit view, a developer must enable it in code. In Startup.cs, configure CmsFeatureOptions so that SectionsVisibility.OnPageEditing is true.

using EPiServer.Cms.Shell.UI.Configurations;

services.Configure<CmsFeatureOptions>(options =>
{
    options.SectionsVisibility.OnPageEditing = true;
});

On-page editing lets you edit content directly on the rendered page rather than in the Visual Builder outline. This editing mode is useful when you want to see exactly how your changes look in context as you make them.

All content displays in the Visual Builder by default. Switch to on-page editing for pages and shared block content only. Experiences use only Visual Builder.

For pages and shared block content, you can switch from the Visual Builder to on-page editing by clicking Select view > On-Page Editing.

Screenshot of the Select view drop-down with the On-Page Editing option where editors switch from Visual Builder to on-page editing mode

From here, you can start editing content; the areas available for editing are highlighted, as shown in the following image.

Screenshot of the on-page editing view with highlighted editable areas on the rendered page where editors click to modify content inline

The available areas depend on how the page type is defined. Each area is configured with a property type that controls what you edit in that area. For example, one area has an image property type for images. Another area has a page description property for text. The editing options when clicking an area depend on the property type. Typically, for a page, edit the page name, description, the main editorial area, and a content area with shared blocks.

📘

Note

Areas and properties available for editing are implementation-specific and depend on the property type and how the rendering is built on your application.

Edit a page with on-page editing

This example describes how to edit a page, but the procedure is similar when editing shared blocks.

  1. Select the page to edit from the page tree in the navigation pane.

    Screenshot of the page tree in the navigation pane where editors select a page to edit
  2. Click an area to edit (property names are displayed on mouse-over).

  3. Make your changes by updating the content properties as needed. For updating rich text content, see Edit content using TinyMCE.

    Screenshot of content properties being edited in the on-page editing view where editors update text and property values directly on the page

    Your changes save automatically in a draft version of the content.

  4. Click Preview at any time to see what the published version will look like.

    Screenshot of the Preview button in the editor toolbar where editors preview the published version of their content
  5. Click Publish > Publish Changes to publish the content when ready.