Skip to main content

Configuring a release

After adding a release in Release Management, you are automatically taken to the release configuration page.

Managing_releases.png

You can also reach this page from the Releases page by clicking on the "project_selector_arrow.png" button next to a release.

upcoming_releases.png

You can use the menu options on the left navigation bar to switch between the configuration of the release and the release stages. Each of these options enables you to manage your release in different ways:

  • Configuration: Edit your release description, schedule release stages, and delete the release.

  • Release candidate: Specify which branch you want to release from, and a Workflow that can generate the necessary file (for example, with the Xcode Archive & Export for iOS Step).

  • TestFlight: Upload the selected Release Candidate to TestFlight (App Store Connect), and distribute it to internal and external testing groups. This is only available for iOS apps.

  • Google Play: Upload the selected Release Candidate to Google Play, and distribute it to testing tracks. This is only available for Android apps.

  • Approvals: Create tasks for each stakeholder and/or team member whose approval is needed to continue with the release.

  • App Store review: Send your app to App Store review. This is only available for iOS apps.

  • Release: Monitor the status of an automatic release (for iOS apps) or manage the release of your app manually.

After completing a stage, it will have a green checkmark next to it on the left menu. After finishing all stages your app will be released.

Editing the description of a release

To edit the description of an existing release:

Release description is internal only

The release description is internal only, and it will not be included in the submission. You can modify the description of your release anytime in the Release Configuration window after creating the release.

  1. Open the release configuration page of a release.

  2. Select Configuration on the left navigation bar.

  3. Click on the Edit information button to open the Edit Release details window.

  4. After updating the description, click Save.

Scheduling stages for the release

You can set up a timeline for the main stages of your release to transparently communicate to your team when each stage will be expected to be finished.

To do so:

  1. Open the release configuration page of a release.

  2. Select Configuration on the left navigation bar.

  3. Click on Schedule stages.

  4. In the Edit Timeline window, fill out each relevant stage's target date.

    edit_timeline.png
  5. Click Save.

Deleting a release

Deleting a release is permanent!

Deleting a release is irreversible and you will lose all data of the release in Release Management.

Your data in TestFlight, App Store Connect, or Google Play will not be lost, and ongoing processes in the App Store or the Google Play Store will not be affected. App Store review will not be canceled. The app will be automatically released as configured.

If you want to delete a release, follow these steps:

  1. Open the release configuration page of a release.

  2. Select Configuration on the left navigation bar.

  3. Scroll down to the Danger zone section, and click on Delete release.

  4. Click Delete once more to confirm.