In this article

Manual release decides when an approved app version is released. Phased release controls how an eligible update reaches users with automatic updates. Neither is a universal rollback mechanism. Choose the release timing and the rollout behavior as separate decisions.

Apple's phased-release documentation, checked October 8, 2026, describes a seven-day progression for eligible updates. People can still manually download the update during that period.

Decide what control you need#

If the concern is coordinating an approved release with support, backend readiness or an announcement, review the app version's release option. If the concern is gradually observing an update among automatic-update users, review phased release.

An update waiting for developer release and an update already distributing in phases are different operational states. Use the provider's actual status rather than labeling both “scheduled.”

For current timing controls, consult Apple's version release options.

Understand the limits of a phase#

Apple's current schedule increases the automatic-update audience over seven days. It also says manual downloads remain available to anyone. Do not tell stakeholders that a phase percentage caps all installations.

A phased rollout is useful only if you can observe the behavior that matters. Identify the supported versions, crash signals, authentication failures and service indicators you will watch. Compare the new version with an appropriate previous-version baseline, accounting for small samples and differing audiences.

These are suggested operational criteria, not Apple's guaranteed measurements or a promise that a small phase prevents every incident.

Prepare a release decision card#

Before releasing, record:

text
Approved version/build:
Release timing owner:
Backend compatibility confirmed:
Phased option and applicability:
Signals to monitor:
Conditions to pause or investigate:
Hotfix owner and communication path:

The card should be specific enough that another operator knows who can act. “Monitor errors” is weaker than naming the relevant app version and incident threshold your team has chosen from its own baseline.

Do not fabricate a universal safe crash-rate threshold. Decide with evidence from your application's audience and risk.

Pause without promising reversal#

Apple allows pausing a phased release within its documented total pause allowance. The current guidance specifies up to 30 days in total and explains how resuming continues the phase.

Pausing does not uninstall the update from people who already have it. Because manual downloads remain possible, it should not be described as making the binary unavailable to everyone.

If a serious defect is discovered, follow the incident process: assess affected users, prepare a compatible fix, and use supported availability or release controls appropriate to the problem. Review the consequences before removing an app from sale; Apple's phase guidance describes different behavior if availability is interrupted.

Verify the public outcome#

After the authorized release action, record the provider state and verify the intended version's availability. Separate that observation from CI success and review approval.

Our CascadeCI introduction describes these lifecycle distinctions. Keep the same precision in your release announcement: name what is approved, what is distributing and what still depends on observation.