Skip to main content Skip to complementary content

Promoting artifacts

If required, you can promote only the artifacts that are of interest for you in the source environment.

Before you begin

  • You must be assigned to the promotion.
  • Ensure that no other promotion is running at the same time on the same source and target environments.
  • You must have access to at least one workspace in the target environment.


  1. Open the Promotions page.
  2. Hover over the promotion you want to use and click the Promote icon.
  3. On the Promote page in the Configuration step, select Artifact as the scope of the promotion.
  4. Select the workspace and specific artifact from the drop-down lists.
  5. Optionally, type in any information about the promotion in the Notes field.
  6. Click Analyze.

    The promotion analysis is displayed.

    The object is in one of the following promotion states:
    Created The object does not exist in the target environment and will be created.
    Reused The object exists in the target environment with the same version.
    Replaced The object exists in the target environment and will be replaced by the source environment version.
    Failed The object cannot be promoted because of a conflict.
  7. If you agree with the promotion analysis, click Promote.
    Promotion of an artifact.


Once the promotion is done, either successfully or with warnings, the Promotion details page opens on the Run history tab. It indicates the status of your promotion. You can access the full promotion history for the promotion by clicking View history. If the promotion fails, a notification appears on the Promotion analysis page to show the promotion errors.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!