Promoting Launches

Last update: March 5, 2025

CREATED FOR:

  • User
  • Admin
  • Developer

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.
  • Whether to delete the launch after being promoted.
NOTE
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.
CAUTION
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).
CAUTION
When promoting launches for modified pages, modifications in both the source and launch branches are considered.

Promoting Launch Pages

NOTE
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 are shown.

      2. Select Launches (for example, 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 (click the thumbnail).
      2. Select Promote.

  2. In the first step you can specify:

    • Target

      • Delete launch after promotion

    • Scope

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

    For example, when selecting to only promote modified pages:

    launches-pd-06

    NOTE
    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:

    Review pages to be promoted

  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 opens the wizard to collect the information needed.

Promote Launch

NOTE
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).

Overview of promoting a nested launch

  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:

    • Target

      • Promotion target
        You can promote to any of the sources.

      • Delete launch after promotion
        After promotion the selected launch, and any launches nested within it, will be deleted.

    • 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

    Settings for promoting a launch

  4. Select Next.

  5. Review the promotion details before selecting Promote:

    Review details and Promote

    NOTE
    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:

    Launches console