Previewing Content


To enable the preview feature on environments created before August 3rd, 2021, make sure the environment is at AEM version 2021.05.5368.20210529T101701Z or higher and then execute a customer-initiated pipeline.

AEM offers a Sites Preview Service that is designed to let developers and content authors preview a website’s final experience before it reaches the publish environment and is available publicly.

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

Also read about accessing the Preview service.

Publishing Content to Preview

You can publish content to the Preview Service by using the Managed Publicaton UI as follows:

  1. Select the page or pages you wish to send to preview in the sites console 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 on the Preview environment.

    Or to see the preview content, you can also append preview to the publish URL of your production instance.

    The URL should be constructed like this:


See Managing Environments for more information on how to get 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.

Configuring OSGi Settings for the Preview Tier

Thr preview tier’s OSGI property values are inherited from the publish tier, but the preview tier values can be distinguished from the publish tier using environment-specific values setting the service parameter with the value “preview”. Take the example below of an OSGI property that 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