How to Create a Promotion

Updated 2 months 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 creates a Promotion and a Deployment record of the selected user story and automatically executes the deployment.

To promote a single user story:

  1. Navigate to the User Stories tab and select 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 by integrating them into 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 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
  1. First, ensure the user stories have been marked as Ready to Promote.
  2. Navigate to the Pipeline record and click on the Pipeline Manager link to open the Pipeline page:

  1. Click on the right arrow next to the environment from which you want to promote user stories:

  1. This will open a page where you can see all the user stories in that particular 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 if you are promoting Apex code:

  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 record and click on the link to open the Release Management page:
  2. In the Release Management page, use the right arrow next to the environment from which 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?