Publishing Updates to Your Custom Mobile App in the App Store
After your white-label mobile app is available on the App Store, you may need to release new versions that include bug fixes, feature enhancements, or updated branding. This article explains how to submit an update for your existing iOS application.
Before You Begin
Ensure you have the following prerequisites ready:
- Access to your Apple Developer Account.
- A new compiled version of your app, which has been uploaded using Xcode or Apple Transporter.
- Any updated app store assets, such as screenshots or descriptions, if they have changed.
Step 1: Generate a New App Build in the CRM
Navigate to the mobile app section within your CRM. Select the option to generate a new build for your app and start the build process. The interface will display the progress; wait for the build to complete successfully.
Step 2: Access App Store Connect
Go to the App Store Connect website and log in with your Apple Developer account credentials. From the main dashboard, select the specific app you wish to update. Your app will be listed along with its current live version number.
Step 3: Add a New App Version
On your app's management page, click the button to add a new version. You will be prompted to enter the new version number. Important: This version number must exactly match the version number of the build you uploaded from Xcode. Version numbers must follow a sequential order (for example, 1.0, then 1.1, then 1.2).
Step 4: Provide Updated App Information
If necessary, update the following information for the new version:
- Release Notes: Clearly describe the new features, improvements, or bug fixes included in this update.
- Screenshots: Upload new screenshots if the app's user interface or user experience has changed.
- App Metadata: Review and update the description, keywords, and support URL if needed.
Step 5: Select the New Build
In the build section of the app version page, choose the option to select a build before submission. From the list of available builds, select the new build you recently uploaded. Save your selection.
Step 6: Review Privacy and Compliance Details
Confirm that your app's privacy policy URL is still correct and accessible. If your update introduces any new data collection practices, you must revisit and update the App Privacy questionnaire.
Step 7: Submit the Update for Review
Carefully review all the information you have entered, including the app icon, screenshots, and metadata. Once everything is correct, click the button to submit the app for review. Apple's review team will evaluate your update before it is approved and released to the App Store.
Troubleshooting Common Issues
- Build Not Appearing: If your new build is not visible in App Store Connect, verify that it was uploaded successfully via Xcode or Transporter and that the correct version number was used.
- Version Number Mismatch: The version number you enter in App Store Connect must be identical to the version number specified in your Xcode project.
- App Rejection: If Apple rejects your update, carefully read the reason provided, make the necessary corrections, and resubmit the app.