Release automation

You can specify events in the release management process that triggers a selected Workflow or Pipeline. For example, you can create an automation that triggers a Workflow whenever an App Store review is cancelled.

Standard plan only

Please note that this feature is only available on a paid plan.

Env Vars from Release Management

Release Management passes over certain Environment Variables to your builds at the Release candidate stage and later at the Release stage: Available environment variables. You can use these Env Vars in your builds triggered by automations.

To configure a release automation:

Configuring automations for a release

You can configure automations separately for each individual release:

1. Log in to Bitrise, and from the left sidebar, select Releases.

2. Select your app from the list.

   

3. Select Releases and then select your release.

4. Select Configuration on the left navigation bar.

5. In the Release process section, find Automation.

6. Click Show details and then click Add automation.

   

7. Under the Event field, select a release management event that will trigger the Workflow or Pipeline.

   

8. Set the automation type to either Workflow or Pipeline.

9. Click Add automation.

Configuring automations as a release preset

You can configure automations as a release preset. These automation settings will be applied to every new release afterwards.

1. Open Release Management and select your app.

2. Select Release presets from the left navigation menu.

   

3. Click next to the name of your preset template and select Change.

4. In the Release process section, find Automation.

5. Click Show details and then click Add automation.

6. Under the Event field, select a release management event that will trigger the Workflow or Pipeline.

   

7. Set the automation type to either Workflow or Pipeline.

8. Click Add automation.

Automation events

Here you can find all of the events which can trigger Bitrise CI Workflows. Release automations will have an Environment Variable (Env Var), called $RM_EVENT_ID, which identifies the trigger. You can find more Release Management Env Vars in Available Environment Variables.

Stage	Event	Event description	Event ID
Release candidate	Release candidate set	This event is triggered each time there is a new release candidate is selected in the Release candidate stage. This can happen automatically (a new build generated a new IPA) or manually (the release manager locks a specific artifact on the Release candidate stage).	release_candidate_set
TestFlight upload	Upload and processing finished	This event is triggered when TestFlight processing is finished for an uploaded IPA. First we upload the IPA to TestFlight, then the TestFlight processing starts. When the processing finishes, we trigger the event.	testflight_upload_finished
Approved by TestFlight App Review	This event is triggered when Apple approves the beta app review that is required for sharing the app with external beta testers.	beta_review_approved
Rejected by TestFlight App Review	This event is triggered when Apple rejects the beta app review that is required for sharing the app with external beta testers.	beta_review_rejected
Released to TestFlight/App Store testing group	This event is triggered when an uploaded build gets released to a TestFlight testing group.	release_for_apple_app_store_testing_group
Approvals	Release approved	This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done. If there are no approval tasks set, the event will trigger immediately after the previous event.	approvals_completed
App Store review	Release sent for review	This event happens when the store review submission starts. (Release Manager clicks on the submit button, and Apple accepts it)	submitted_for_review
Status of review submission changed	This event is triggered each time there is a change in the status of the review submission. (Approved, rejected, canceled)	review_status_changed review_cancelled
Release	Release started	This event is triggered after the submission was accepted, and the release rollout started (so the new version becomes available in App Store Connect)	release_started
Release finished	This event is triggered when the release gets a completed status in Release Management (which means the release is fully rolled out to Google Play or the App Store.)	release_completed

Stage	Event	Event description	Event ID
Release candidate	Release candidate set	This event is triggered each time there is a new release candidate is selected in the Release Candidate stage. This can happen automatically (a new build generated a new AAB) or manually (the release manager locks a specific artifact on the Release candidate stage).	release_candidate_set
Google Play upload	Upload and processing finished	This event is triggered after the AAB is uploaded to Google Play console and is available in the App bundle explorer.	google_play_store_upload_finished
Release on testing track	This event is triggered after the release candidate is released on a Google Play testing track.	release_on_google_play_store_testing_track
Approvals	Release approved	This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done.	approvals_completed
Release	Release started	This event is triggered when a release is started. It can be a full release or a staged rollout. For a staged rollout, it only happens once, at the first rollout.	release_started
Release finished	This event is triggered when release is completed in Release Management.	release_completed
Rollout percentage changed	This event is triggered if the rollout percentage changes from any percentage other than 0%. For example, if the rollout percentage goes from 10% to 20%. It is NOT triggered when the first rollout happens.	release_percentage_changed