Promoting Launches


AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

You need to promote launch pages to move the content back into the source (production) before publishing. When a launch page is promoted, the corresponding page of the source pages is replaced with the content of the promoted page. The following options are available when promoting a launch page:

  • Whether to promote only the current page or the entire launch.
  • Whether to promote the child pages of the current page.
  • Whether to promote the full launch or only pages that have changed.

After you promote the launch pages to the target (Production), you can activate the Production pages as an entity (to make the process quicker). Add the pages to a workflow package and use it as the payload for a workflow that activates a package of pages. You need to create the workflow package before promoting the launch. See Processing Promoted Pages Using AEM Workflow.


A single launch cannot be promoted concurrently. This means that two promote actions on the same launch at the same time can result in an error - Launch could not be promoted (together with conflict errors in the log).


When promoting launches for modified pages, modifications in both the source and launch branches are considered.

Promoting Launch Pages


This covers the manual action of promoting launch pages when there is only one launch level. See:

You can promote launches from either the Sites console or the Launches console:

  1. Open:

    • the Sites console:

      1. Open the references rail and select the required source page using selection mode (or select and open the references rail, the order is not important). All references will be shown.

      2. Select Launches (e.g. Launches (1)) to show a list of the specific launches.

      3. Select the specific launch to show the actions available.

      4. Select Promote launch to open the wizard.

    • the Launches console:

      1. Select your launch (tap/click on the thumbnail).
      2. Select Promote.
  2. In the first step you can specify:

    • Promote full launch
    • Promote modified pages
    • Promote current page
    • Promote current page and sub pages

    For example, when selecting to only promote modified pages:



    This covers a single launch, if you have nested launches see Promoting a Nested Launch.

  3. Select Next to proceed.

  4. You can review the pages to be promoted, these will depend on the range of pages you have chosen:


  5. Select Promote.

Promoting Launch Pages when Editing

When you are editing a launch page, the Promote Launch action is also available from Page Information. This will open the wizard to collect the information needed.



This is available for single and nested launches.

Promoting a Nested Launch

After creating a nested launch you can promote it back to any of the sources, including the root source (production).


  1. As with Creating a Nested Launch, navigate to and select the required launch in either the Launches console or the References rail.

  2. Select Promote launch to open the wizard.

  3. Enter the required details:

    • Promotion target

      You can promote to any of the sources.

    • Scope
      Here you can select whether to promote the entire launch, or only pages that have actually been edited. If the latter, you can then select to include/exclude sub-pages. The default configuration is to only promote page changes for the current page:

      • Promote full launch
      • Promote modified pages
      • Promote current page
      • Promote current page and sub pages


  4. Select Next.

  5. Review the promotion details before selecting Promote:



    The pages listed will depend on the Scope defined and possibly the pages that have actually been edited.

  6. Your changes will be promoted and reflected in the Launches console:


Processing Promoted Pages Using AEM Workflow

Use workflow models to perform bulk processing of promoted Launches pages:

  1. Create a workflow package.
  2. When authors promote Launch pages, they store them in the workflow package.
  3. Start a workflow model using the package as the payload.

To start a workflow automatically when pages are promoted, configure a workflow launcher for the package node.

For example, you can automatically generate page activation requests when authors promote Launches pages. Configure a workflow launcher to start the Request Activation workflow when the package node is modified.


On this page