How to Create a Promotion

Updated 1 month ago by Copado Solutions

Promoting a Single User Story

Copado allows you to promote user stories individually with the Promote and Deploy feature. This can be useful, for instance, if you want to apply a minor fix to a bug which does not share any dependency to another user story.

When using the Promote and Deploy feature, Copado will create a Promotion and a Deployment of the selected user story and will automatically execute the deployment.

To promote a single user story:

  1. Navigate to the user story you want to promote.
  2. Check the Promote and Deploy checkbox:

Promoting Multiple User Stories

Copado allows you to promote user stories in bulk integrating them in a single promotion. In order to do this, the user stories you want to promote must be flagged as Ready to Promote:

Once the user stories have been flagged as Ready to Promote, they will be ready to be promoted and will be available for selection.

You can promote multiple user stories in 2 ways:

  • From the Promotion Record
  • From the Pipeline page or Release Management page (v12 or under).
From the Promotion Record
  1. Before creating the Promotion record, make sure that the user stories have been marked as Ready to Promote.
  2. Navigate to the Promotions tab and click on New.
  3. Select the Project or the Release. It is possible to create a promotion for user stories that belong to a project or to a release regardless of the project.
  4. Add the Source Environment. Copado will automatically fill in the source org credential, the destination environment and the destination org credential based on the pipeline related to the project or the release of the project and the available credential owned by the running user.
If an org credential is marked as Default Credential, the promotion will use that credential regardless of the owner. This allows sharing the "deployment" org credential among multiple release managers. This behavior can be modified following the steps detailed in the article Org Credentials Update.
  1. Locate the required user stories from the Available User Stories list, check them and click on Add selected User Stories. The selected user stories will be then displayed under the Selected User Stories related list.
  2. When using Ready to Promote, Copado will not create the deployment automatically, this will have to be manually performed from the Promotion record. To learn more, please visit the article Creating a Deployment.

From the Pipeline Page

This Interface is available if you are in Summer '19.

  1. First, ensure the user stories have been marked as Ready to Promote.
  2. Navigate to the Pipeline and locate the Manage Releases field. Then, click on the Pipeline Manager link to open the Pipeline page:

  1. Click on the arrow beside the user stories count:

  1. This will open a new page where you can see all the user stories in this environment that are ready to be promoted, regardless of their project:

  1. Flag the user stories you are interested in promoting and choose the test level you want to apply to the deployment:

  1. Click on Promote (you will later need to manually create and launch the deployment) or on Promote & Deploy (Copado will automatically create a Promotion record and deploy the user stories).

From the Release Management Page

This Interface is available if you are in Copado v12.

  1. Navigate to the deployment flow and locate the Manage Releases field. Then, click on the link to open the Release Management page:
  2. In the Release Management page, use the arrow for the environment where you want to promote the user stories:
  3. Choose the User Stories Ahead tab.
  4. Choose the Project or Release that contains the user story.
  5. Select the user stories you want to promote.
  6. Click on Promote (you will later need to manually create and launch the deployment) or on Promote & Deploy (Copado will automatically create a Promotion record and deploy the user stories):


How did we do?