Update your app

Create a new version

When you’re ready to distribute a new version of your app, you create a version using the same app record you created for the original version.

Keep in mind that it's not possible to revert to a previous version on the App Store if you have an issue with your app. You must create and submit a new version. You can only create a new version if the current version status is Ready for Distribution.

Learn about creating a new version using App Store Connect API.

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

  1. From Apps, select your app. The page opens with the Distribution tab selected.

  2. In the sidebar, click the add button (+) next to the desired platform.

  3. In the New Version dialog, enter an incremental App Store version number, and click Create.

  4. Review and enter metadata about the new version.

    When you create a new version, the metadata from the current version is transferred to the new version automatically.

    For a description of the version properties, visit Platform version information. For the required and localizable properties, refer to Required, localizable, and editable properties.

  5. On the top right, click Save.

  6. Upload your new build to App Store Connect.

    In Xcode, increment the build string before you upload your build to App Store Connect, as described in Set the version number and build string.

  7. When you are ready to submit your build, add it to your latest version, then submit your app to App Review.