Uploading a Build for an App

Uploading a Build

Once you have created and saved an iTunes Connect record for an app, you can upload a build. Only users with the following roles can upload builds to iTunes Connect: Admin, Technical, App Manager, and Developer.

As you continue to change your app, you can upload new builds. Uploading the first build for the app creates a new prerelease version of the app.

After you upload your build to iTunes Connect, it needs to be processed in Apple’s system. After it finishes processing, Apple will send you an email.

There are two tools to help you upload builds into iTunes Connect: Xcode and Application Loader.

Using Xcode

The Xcode development environment is tightly integrated with iTunes Connect. When you add an app to iTunes Connect, uploading a build for your app using Xcode is straightforward and efficient. When your iTunes Connect record is ready, Xcode receives metadata from the available record. From inside Xcode, you associate the build with the iTunes Connect record you created for the app and complete the upload. For more information, read Uploading Your App to iTunes Connect in App Distribution Guide.

Using Application Loader

Application Loader is a tool to help you upload your apps to iTunes Connect. It’s particularly helpful if your app includes in-app purchase products that need to be configured for the app. Application Loader is explained in Using Application Loader.

To launch Application Loader

  1. Launch Xcode.

  2. Choose Xcode > Open Developer Tool > Application Loader.

Numbering Versions and Builds

When you upload a build for the app, iTunes Connect extracts its prerelease version number and build number from the build. The prerelease version number is the Xcode Version number, or the “Bundle version string, short” key in the Info.plist. The build number is the Xcode Build number, or the “Bundle version” key in the Info.plist. The prerelease version number and build number will be shown in the Prerelease pane, as described in Viewing Builds.

Viewing Builds

You can view the full set of builds you have uploaded for the app. Some of these builds will stop being visible after the app goes live.

To view prerelease versions and builds

  1. Open the App Details page, as described in Creating an iTunes Connect Record for an App.

  2. Click Activity.

The All Builds pane shows a list of the builds you have uploaded for the app, separated by platform type. Each platform shows a separate section listing the builds uploaded for each prerelease version. See Numbering Versions and Builds for an explanation of how prerelease version numbers and build numbers are determined.


If you click on the build number, you can see additional details about the build you uploaded, such as whether your build contains an iMessage extension or uses SiriKit.

You can see the history of your App Store version by clicking App Store Versions from the left pane.

When you are ready to submit your app for App Review, you will select a particular build to use for that App Store version.

Choosing a build in order to submit your app for App Review is explained in Choosing a Build. If you want to test your app before submitting for App Review, see TestFlight Beta Testing (iOS, tvOS, watchOS).