App Store Connect/Update your app/Release a version update in phases
Update your app
Release a version update in phases
iOSmacOStvOS
When you release a version update of your app, you can choose to release the new version to the App Store in stages. This option is available when you submit a version update and your app has one of the following statuses:
Yellow clock symbol Prepare for Submission
Yellow clock symbol Waiting for Review
Yellow clock symbol In Review
Yellow clock symbol Waiting for Export Compliance
Yellow clock symbol Pending Developer Release
Red X square fill symbol Developer Rejected
Red X square fill symbol Rejected
Red X square fill symbol Metadata Rejected
Selecting this option will release your app's update gradually over 7 days. A random sample of users with automatic updates on eligible devices will receive the update, without any notification of their participation in the phased release.
Day of Phased Release
Percentage of Users
1
1%
2
2%
3
5%
4
10%
5
20%
6
50%
7
100%
Keep in mind that apps and app updates in phased release can be manually downloaded from the App Store by anyone at any time.
During phased release, you may pause the release for up to 30 days, with no limit on the number of pauses. If you remove your app from sale, phased release will stop and won’t be available for that version again.
In the sidebar, click the app version you want to submit.
On the right, scroll down to the Phased Release for Automatic Updates section, select Release update over a 7-day period using phased release.
Screenshot of the app version detail page, where there are two options under Phased Release for Automatic Update section: "Release update to all users immediately" and "Release update over 7-day period using phased release". The "Release update over 7-day period using phased release" option is selected.
Click save.
When you submit your app for review and it's approved, the app status will be Ready for Distribution, and will be appended with "Phased Release" next to the status when viewing your app's version page.
When the update is complete, all users with Admin or App Manager roles who have access to this app will receive a notification regarding the completion of the phased release.
Pause and resume a phased release
In Apps, select the app you want to view.
In the sidebar, click the Ready for Distribution app version.
In the Phased Release for Automatic Updates section, you can either pause the release by selecting Pause Phased Release or resume it by using the Use Phased Release option.
Click Save.
You can pause your release for a total of 30 days. For example, if you pause the release for 10 days and then choose to resume it, you will have 20 days remaining to pause the release again. If you resume a release that was previously paused, your phased release will pick up on the day it was left off when it was paused.
Release a version update to all users
If you decide to release your app in phases, you can release it to all users at any time once it has the Ready for Distribution status. When you select this option, all users whose devices have automatic updates turned on gets the latest app version supported on the user’s device.
In Apps, select the app you want to view.
In the sidebar, click the app version that you've submitted.
On the top right of the page, click Release to All Users.