Skip to main content

​
Overview: Promoting flows

Promoting a flow means copying it from one environment to another. This allows the same test logic to be reused across environments without rewriting the flow. QA engineers typically promote a flow to validate the same behavior at different stages of delivery—for example, confirming that a critical path behaves the same in a preview environment as it does in a later environment. The goal is consistency: ensuring that a trusted flow continues to deliver value as the application progresses.
Not every flow needs to run in every environment. Promoting flows indiscriminately can introduce noise, increase maintenance, and cause failures unrelated to the environment’s purposeBefore promoting a flow, consider whether it adds a meaningful signal in the target environment. Promotion is most effective when it is intentional and aligned with a clear testing goal.

​
How to: Promote a flow

  1. You can promote workflows between environments in either direction.
  2. Every environment contains the same Groups. Promoted flows will automatically be assigned to the same group they came from.
  3. Changes made to a workflow in one environment aren’t automatically reflected in other environments.
  4. Each environment maintains its own version of the workflow unless you manually promote changes between them.

​
Promote all flows

1
Click the Promote all button at the bottom of the Flow list. The Promote Changes dialog will appear.
2
Select the environment the flows should be promoted to.
3
Click Preview promotion. The review displays code differences for each promoted workflow.If you promote a workflow to an environment where it doesn’t yet exist, the left side will be empty, and the right side will show the workflow’s complete code.
4
Click Promote to environment in the top-right corner.

​
Promote selected flows

1
Select the flows you want to promote from the Flows list.
2
Click the Promote selected button at the bottom of the Flow list. The Promote Changes dialog will appear.
3
Select the environment the flows should be promoted to.
4
Click Preview promotion. The review displays code differences for each promoted workflow.If you promote a workflow to an environment where it doesn’t yet exist, the left side will be empty, and the right side will show the workflow’s complete code.
5
Click Promote to environment in the top-right corner.
Last modified on February 9, 2026