Skip to main content

Configuring a release

After adding a release, 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 an .xcarchive file (for example, with the Xcode Archive & Export for iOS Step).

  • TestFlight upload: Upload the selected Release Candidate to TestFlight (App Store Connect).

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

  • App Store review: Send your app to App Store review.

  • Release: Monitor the status of an automatic release or manage the release of your app.

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 App Store review submission (metadata).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 and in App Store Connect will not be lost, and ongoing processes in the App 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.

In this section: