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.

Presets are automatically applied when you add a new release and select the Start with a blank release method. After the presets are applied, you can still edit these values during the release process.

You can configure presets for:

Configuring release presets

To configure release presets:

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

  2. From the Connected apps list, select your app.

    rm-overview-connected.png

  3. On the left, select Presets.

    presets.png

  4. Select and configure the available 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 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 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. Select Release presets on the left.

  3. Find App Store metadata.

  4. From the dropdown menu, select a localization.

    release-notes-menu.png

  5. Click What's new in this version and then Edit metadata.

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

  7. Click Save changes.

  1. Open your app in Release Management.

  2. Select Release presets on the left.

  3. Find Release notes.

  4. From the dropdown menu, select a localization.

    release-notes-menu.png

  5. Click Edit. This opens the Edit release notes dialog.

  6. 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

  7. 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.

  1. Open your app in Release Management.

  2. Select Release presets on the left.

  3. Find Release notes.

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

    copy-metadat.png

  5. Open the Copy to dropdown menu, and select all localizations you want to copy to.

  6. Click Copy.

In this section: