How do I switch between workflows in my app with the Flutter Workflow Editor?

Last updated: July 27, 2026

Context

If your app was configured using Codemagic’s Flutter Workflow Editor and has multiple workflows, you can choose which workflow to view, edit, or run.

The workflow named Default Workflow is usually the original workflow created for the app.

Switching workflows in App Settings

  1. Open the app in Codemagic.

  2. Go to App settings.

  3. Click the current workflow name displayed below the app name.

  4. Select Default Workflow or another workflow from the dropdown.

The settings page will then display the configuration for the selected workflow.

Image of a UI screen showing a Workflow Editor with a dropdown menu labeled Search for workflow... containing options Default Workflow and Different Workflow under a header that includes the app name codemagic_hello_world_flutter.

Selecting a workflow when starting a build

  1. Click Start new build.

  2. Select the branch you want to build.

  3. Choose Default Workflow or another available workflow.

  4. Start the build.

Image of a UI dialog titled Specify build configuration showing options to build a branch or tag, with fields to select a branch and a dropdown to choose a workflow.

Note: These instructions apply to apps configured with the Flutter Workflow Editor.

For apps configured using codemagic.yaml, workflows are defined under the workflows section of the YAML file. You choose one of those workflows when starting a build rather than switching to a workflow named Default Workflow.