Skip to main content

Release presets

Abstract

Release presets are default values and configurations for new releases of a connected app on Bitrise Release Management. Presets are automatically applied when you add a new release.

Release presets are default values and configurations for new releases of a connected app. To set a preset for a release, you need a preset template. A preset template is a combination of various preset options. You can apply a template to a release when adding a new release.

You can configure presets for:

Creating a preset template

To create a preset template:

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

  2. Select your app from the list.

    2025-08-07-rm-your-apps-list.png
  3. On the left, select Release presets.

    2025-08-07-release-presets
  4. Click + New template.

  5. Add a name and click Create.

  6. Click 3_dots.png next to the name of your template and select Change.

  7. Select and configure the available release preset options:

    • In the Configuration section, configure preset options for the initial release configuration.

    • In the Release candidate section, create a build configuration for the release candidate stage.

    • Release rollout/App Store release settings allow you to configure phased release for Android and iOS apps, respectively. By default, updates are released immediately to all users.

    • Release notes/App Store metadata allow you to add release notes to your release.

Release preset options

The preset options for the initial release configuration:

  • Auto-upload: Enable or disable it with the toggle switch. This is a preset for the Auto-upload configuration of releases.

  • Approvals: Create default approval tasks for new releases. This is a preset for the Approvals configuration of releases.

  • Notifications: Enable Slack and Teams notifications for all new releases with the same settings. This is a preset for the Notifications configuration of releases.

  • Automation: Configure default automation events with their triggered Workflow or Pipeline. This is a preset for the Automation configuration of releases.

Preset options for the release candidate stage:

  • Build configuration: You can select the release branch for the app and the Workflow that generates the build with a signed IPA or AAB file.

Preset options for the review and release stage:

  • Release note: You can create a release note preset for Android apps.

  • App Store metadata: You can create a release note preset for iOS apps.

For details, read Release note preset.

Release note preset

You can create a release note preset. This means every release will be submitted to the App Store or Google Play with the same release notes.

A release note preset can be identical in all localizations.

Manual edit

You can edit a release note in the release stage, before submitting your app to an online store. A manual edit will override the release note preset.

Editing a release note preset

To create and save a release note preset:

iOS

Android

  1. Open your app in Release Management.

  2. On the left, select Release presets.

    2025-08-07-release-presets
  3. Click 3_dots.png next to the name of your template and select Change.

  4. Find App Store metadata.

  5. From the dropdown menu, select a localization.

    2025-08-07-app-store-metadata.png
  6. Click What's new in this version and then Edit metadata.

  7. Add your release note in the What's in your release field.

  8. Click Save changes.

  1. Open your app in Release Management.

  2. On the left, select Release presets.

    2025-08-07-release-presets
  3. Click 3_dots.png next to the name of your template and select Change.

  4. Find Release notes.

  5. From the dropdown menu, select a localization.

    release-notes-menu.png
  6. Click Edit. This opens the Edit release notes dialog.

  7. Add your release note in the What's in your release field.

    Optionally, you can check Use same content for all localizations to include the same text for all languages.

    release-note-preset.png
  8. Click Save changes.

Copying a release note preset to other localizations

If you don't want to automatically use the same preset for all localizations, you can copy your preset to specific localizations.

iOS

Android

  1. Open your app in Release Management.

  2. On the left, select Release presets.

    2025-08-07-release-presets
  3. Click 3_dots.png next to the name of your template and select Change.

  4. Find App Store metadata.

  5. Click into What's new in this verseion, and then click Copy to. This opens the Copy metadata dialog.

    copy-metadat.png
  6. Open the Copy to dropdown menu, and select all localizations you want to copy to.

  7. Click Copy.

  1. Open your app in Release Management.

  2. On the left, select Release presets.

    2025-08-07-release-presets
  3. Click 3_dots.png next to the name of your template and select Change.

  4. Find Release notes.

  5. Click Copy to. This opens the Copy metadata dialog.

    copy-metadat.png
  6. Open the Copy to dropdown menu, and select all localizations you want to copy to.

  7. Click Copy.