Bitrise Immerse

Versions

Managing Versions

Editing, deleting, and browsing versions in your rollout.

This guide covers how to browse your version list, edit version metadata, understand version statuses, and delete versions.

Version List Page

The version list shows all versions for a rollout, located at:

/beta/rollouts/{askId}/{rolloutName}/versions

Navigate here from the rollout’s checklist page by clicking “Versions” in the navigation.

version-list

The version list showing multiple versions at different pipeline stages

What the List Shows

Each version in the list displays:

  • Version number (e.g., 1.2.6)
  • Platform (iOS or Android)
  • Status badge (Draft, In Progress, Completed, Rejected)
  • Current pipeline stage
  • Creation date

Actions

  • Click a version to open its pipeline view (Version Details page)
  • “Create Version” button (top-right) to start a new release

Version Statuses

StatusMeaningTypical Situation
DraftVersion was just createdIn the Release Candidate stage, before an artifact is selected
In ProgressActively moving through the pipelineWorking through Testing, Approvals, or App Store Review
CompletedReleased to productionApp is live on the App Store
RejectedRejected during approvals or reviewAn approver rejected, or Apple rejected the App Store review

Editing Version Metadata

You can update a version’s metadata at any time using the Version Configure page.

  1. Open the version's pipeline view

    Click on the version from the version list to open the Version Details page.

  2. Click Configuration

    Click the “Configuration” button in the top-right corner of the page header.

    version-configure

    The Version Configure page with editable metadata fields

  3. Edit the metadata fields

    FieldDescription
    What’s NewRelease notes visible to end users in the app store
    Release DescriptionInternal description for your team
    Target Release DateWhen you aim to release this version
    Version Application NameThe app name for this specific version

  4. Save or discard changes

    • Save (top-right) — Saves your edits
    • Discard (top-right) — Reverts to the last saved state
Version number and hotfix status are set at creation and displayed as read-only on this page.

Deleting a Version

Versions can be deleted from the Version Configure page.

  1. Open the Version Configure page

    Navigate to the version and click “Configuration” in the header.

  2. Scroll to the Danger Zone

    At the bottom of the page, find the Danger Zone section.

  3. Click Delete Version

    Click the “Delete Version” button (red).

  4. Confirm deletion

    A confirmation dialog appears. Type the version number to confirm, then click Confirm.

    delete-version-confirm

    The delete version confirmation dialog

Deleting a version cannot be undone. All approval progress, form submissions, and release data for this version will be permanently removed. The version record, all associated approval records, and the linked Bitrise release will be deleted.

Multiple Versions

You can have multiple versions for the same rollout, each at different stages. This lets you manage overlapping releases — for example, working on a feature release while also pushing a hotfix.

What’s Next