Promoting Launches

Last update: May 3, 2023

CREATED FOR:

  • User
CAUTION
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.
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 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:

    chlimage_1

    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:

    chlimage_1-1

  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.

chlimage_1-2

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

chlimage_1-3

  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

    chlimage_1-4

  4. Select Next.

  5. Review the promotion details before selecting Promote:

    chlimage_1-5

    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:

    chlimage_1-6