# Promoting spaces

Promote spaces with pre-configured analysis.

## 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 space in the target environment.
* Plans must be run at least once before they can be promoted.

## About this task

Personal spaces cannot be promoted.

## Procedure

1. Open the Promotions page.
2. Right-click the promotion you want to use and click Promote.
3. On the Promote page in the Configuration step, select Space as the scope of the promotion.
4. Select the space and specific space from the drop-down lists.
5. Specify how to handle resources during the promotion.
   | Action | Description |
   | --- | --- |
   | Keep target | Existing resources are not affected by the promotion. |
   | Override | Promoted resources take precedence over the<br>target environment's resources. |
6. Specify how to handle run profiles during the promotion.
   | Action | Description |
   | --- | --- |
   | Keep target | Existing run profiles are not affected by the promotion. |
   | Override | Promoted run profiles take precedence over<br>the target environment's run profiles. |
7. Optionally, type in any information about the promotion in the Notes field.
8. Click Analyze.

   Analysis may take time when many resources are included. A progress message is displayed while analysis is in progress. Ensure you stay on the Promotion analysis page until the analysis finishes.

   If you leave the page before it finishes, the analysis is canceled. Then you need to return to the promotion wizard and click Analyze to run analysis again. This requirement applies only to analysis. After you click Promote, promotion execution can continue in the background.

   The promotion analysis is displayed.

   The object is in one of the following promotion states:
   | State | Description |
   | --- | --- |
   | Created | The object does not exist in the target environment and will be<br>created. |
   | Reused | The object exists in the target environment with the same<br>version. |
   | Replaced | The object exists in the target environment and will be replaced<br>by the source environment version. |
   | Failed | The object cannot be promoted because of a conflict. |
9. If you agree with the promotion analysis, click Promote.

   ![Promotion of a space.](https://help.qlik.com/talend/en-US/management-console-user-guide/Resources/images/tmc-promotion_analysis_workspace.png)

## Results

Depending on the amount of objects to promote, a promotion can take up to 30 minutes.

If the promotion takes more than 20 seconds, the promotion will continue to run in background. You can continue working in Talend Management Console while the promotion is being executed.

You can view its progress from the Status column in the promotion list or from the Promotion run history page.

Once the promotion is done, either successfully or with warnings, you can open its details panel by clicking the promotion name. In the Overview tab, you can see the details of your last promotion. You can also access the full promotion history by clicking View history.

If the promotion fails, a notification appears on the Promotion analysis page to show the promotion errors.