Previewing Content

AEM offers a Sites preview service lets developers and content authors preview a website’s final experience before it reaches the publish environment and is available publicly.

It facilitates previewing page experiences that would not be otherwise visible from the author environment, like page transitions and other publish side only content.

For more details about the preview environments, please see the document Manage Environments..


Publishing an Experience Fragment to Preview basically follows the same procedure as for a page, though from the Experience Fragments console or editor.

Publishing Content to Preview

You can publish content to the preview service by using the Managed Publication UI.

  1. In the Sites console, select the page or pages you wish to send to preview and click on the Manage Publication button

  2. In the following wizard, select Preview as the destination

    managed publication

  3. Click Next, and then Publish to confirm.

  4. A dialog will display the URLs for accessing the content in the preview environment.

Alternatively to using the URLs displayed in the wizard to see the preview content, you can also prepend preview- to the publish URL of your production instance.


See the document Managing Environments for more information on how retrieve the URLs for your environments.

Content may also be published to preview by using a publish content tree workflow with the agentId parameter set to preview or by using the replication API with an AgentFilter configured for preview.

Unpublishing Content from Preview

Unpublishing content from your Preview environment is basically the same process as unpublishing pages from the Publish environment.

The only difference is that you can select the Destination to be Preview.

Configuring OSGi Settings for the Preview Tier

The preview tier’s OSGi property values are inherited from the publish tier. However the preview tier’s values can be distinct from the publish tier by setting the service parameter to the value preview. The following example of an OSGi property determines the URL of an integration endpoint.

"service": "preview"

For more information, see this section of the OSGi configuration documentation.

Debugging Preview Using the Developer Console

Follow these steps in order to debug the preview tier using the Developer Console:

  • In the Developer Console, select either – All Preview – or a production environment that includes prev in its name
  • Generate the relevant information for the preview instance
    See Managing Environments for more information on how to get the URLs for your environments.

On this page