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. The new version will be available free to customers who purchased a previous version. You can only create a new version if the current version status is Ready for Sale or Developer Removed from Sale.

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.

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 My Apps, select your app. The page opens with the App Store 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 App Store version, then submit your app to app review.