Skip to main content

Adding a new release

Adding a new iOS release using the Bitrise API

You can add new iOS releases using the Bitrise API. For more information, check out Adding a new release using the Bitrise API.

For now, the API only supports App Store releases. Google Play support is coming soon!

You can add a new release from the Releases page of your app:

iOS

Android

  1. Make sure you have:

    • A working Apple services connection.

    • At least one app registered to App Store Connect.

    • A Workflow that generates an .ipa or .xcarchive file.

    For more information, check out Release Management requirements.

  2. Access your app's Releases page.

  3. Select the App Store tab.

  4. Click on the Add new release button.

    Add_new_release.png

    This opens the Add new release for iOS page.

    addnewreleaseforios.png
  5. Select a setup method under the Setup method field.

    • Select Start with a blank release if you want your new release to not inherit any configuration from a previous releases.

    • Select Copy from a selected release, and select one of your other releases from a dropdown menu if you want your new release to inherit the selected app, checklists, automations and settings from that release.

      setup_method.png
  6. If you selected Start with a blank release, select an app you would like to add to your release under the App Store connect field.

    Connection to an Apple service with API key is required

    If you cannot see your API key under the App Store connect field, make sure that you have connected to an Apple service using an API key. For more information, check out our guide.

  7. In the Release information field, specify a release version below the Release Version input and optionally add a description of the release under the Description input.

    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.

  8. Click Add release.

  1. Make sure you have:

    • A working Google Play connection.

    • At least one app registered to Google Play.

    • A Workflow that generates a signed .aab file.

    For more information, check out Release Management requirements.

  2. Access your app's Releases page.

  3. Select the Google Play tab.

  4. Click on the Add new release button.

    This opens the Add new release for Android page.

    add-release-android.png
  5. Select a setup method under the Setup method field.

    • Select Start with a blank release if you want your new release to not inherit any configuration from a previous releases.

    • Select Copy from a selected release, and select one of your other releases from a dropdown menu if you want your new release to inherit the selected app, checklists, automations and settings from that release.

      setup_method.png
  6. If you selected Start with a blank release, go to the Google Play Console section and in the Package name field, type the name of the app you would like to add to your release. The name should exactly match the name on Google Play.

  7. In the Release information field, specify a release name in the Release name input field and optionally add a description of the release under the Description input.

    Release description is internal only

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

  8. Click Add release.

That's it! Your new release is ready, and you will be taken to the release configuration page.