How to Back Promote a User Story Created in a Higher Environment

You may run into a situation where you need to back promote some changes that were applied directly in a higher environment in your pipeline.

In this scenario, we are using production as the higher environment, but this could be UAT, QA, Staging or others.  

  1. Create the User Story and select production as the org credential.
  2. Commit the changes you want to back promote in the User Story and flag it as Ready to Promote.
  3. Go to the Promotions tab and click on New.
  4. Select production as the source environment.
  5. Select the project linked to the pipeline where you want to back promote and set the status to Completed.
  6. Add the User Story to the Promotion record.
  7. The User Story will now be available to be back promoted.

How did we do?