Versions
What Are Rollout Versions?
Learn about versions, how they work, and the release stages for each platform.
A version represents a single release of your mobile app (e.g., v1.2.6). Each version moves through a multi-stage release pipeline from build selection to production release. You can only move to the next stage after completing the current one.
Version Stages
iOS
- Release Candidate: Select the release branch and Workflow that generates an IPA file.
- TestFlight: Upload the release candidate to TestFlight for testing.
- Approvals: Complete all 6 required approval tasks.
- App Store Review: Submit to Apple for review.
- Release on the App Store: Release to all users or configure a phased release.
Android
- Release Candidate: Select the release branch and Workflow that generates an AAB file.
- Google Play Upload & Testing: Upload the release candidate to Google Play for testing.
- Approvals: Complete all 6 required approval tasks.
- Release on Google Play: Release to all users or configure a staged rollout.
Version Statuses
| Status | Meaning | Typical Situation |
|---|---|---|
| Draft | Version was just created | In the Release Candidate stage, before an artifact is selected |
| In Progress | Actively moving through the pipeline | Working through Testing, Approvals, or App Store Review |
| Completed | Released to production | App is live on the App Store |
| Rejected | Rejected during approvals or review | An approver rejected, or Apple rejected the App Store review |
Multiple Versions
You can have multiple versions for the same rollout, each at different stages:
- Version 1.2.5 — Completed (released)
- Version 1.2.6 — In Approvals stage
- Version 1.3.0 — In Release Candidate stage
This lets you manage overlapping releases — for example, working on a feature release while also pushing a hotfix.
Hotfix Versions
Marking a version as a hotfix during creation enables a faster approval path:
- Legal approval is automatically approved — no manual review needed
- All other approvals still require their normal sign-off
Use hotfix mode when you need to push a critical fix quickly and Legal has pre-approved the release pattern. See Create Version for details.
What’s Next
- Create Version — Start a new release
- Pipeline Overview — Understand the full pipeline lifecycle
- Manage Versions — Edit, delete, and browse versions