Manage builds

Choose a build to submit

Before submitting an app to App Review, you'll need to choose a build from those you've uploaded for a version. You can associate only one build with an App Store version. However, you can change the build as often as you want until you submit the version to App Review.

Build section on iOS platform detail page.

Learn how to submit builds for review with the App Store Connect API.

Required role: Account Holder, Admin, or App Manager. View role permissions.

Add a build to a version

  1. From My Apps, select your app. The page opens with the App Store tab selected.

  2. In the sidebar, click the app version under the platform you wish to select.

  3. On the right, scroll down to the Build section, then click the add button (+) next to Build.

    The add button (+) appears if you’ve uploaded builds and haven’t selected a build yet. If a different build is selected than the one you want to submit for review, remove the build.

  4. In the Add Build dialog, select the build you want to submit.

    Add Build dialog on iOS platform detail page.

    If an earlier version of your app has the Ready for Sale status, then the list only includes builds you've uploaded since that version was released on the App Store. Learn how to view available builds.

  5. Click Done.

    In the Build section, the app icon, build string, and upload date and time appear.

    Build section in iOS platform detail page.
  6. On the top right, click Save.

    Note: If you've selected a build with the Missing Compliance status, you’ll need to answer the export compliance questions before you can submit for review. Click Manage or Choose File next to the build and answer the questions, or follow the steps to upload export compliance documentation.

Remove a build from a version

Removing a build from an App Store version doesn’t remove the build from your account.

  1. From My Apps, select your app. The page opens with the App Store tab selected.

  2. In the sidebar, click the app version under the platform you wish to remove.

  3. On the right, scroll to the Build section.

  4. Hold the pointer over the build and click the delete button (–) that appears to the right of the upload date.

    Build section on platform detail page. The pointer points to the delete button.
  5. On the top right, click Save.