Pushing an update to Whitelabel Mobile App
Updating Your Live iOS App in App Store Connect
Once your app is live on the App Store, you may need to release updates with bug fixes, new features, or branding changes. This guide walks you through updating your existing app.
Prerequisites
- Access to your Apple Developer Account
- A new app build (uploaded via Xcode or Transporter)
- Updated metadata (screenshots, description, etc. if needed)
Step 1: Start a New Build
- Click on Launch App > Generate Build > Start App build
- Build progress will show on screen, wait till it gets completed.
Step 2: Log in to App Store Connect
- Visit App Store Connect.
- Log in using your Apple Developer credentials.
- From the Apps Dashboard, select the app you want to update.
> You’ll see your app listed with the current live version.
Step 3: Create a New Version
- Inside your app page, click the Add New Version button.
- Enter the new version number (must match the build version uploaded from Xcode).
⚠️ Note: Version numbers must be sequential (e.g., 1.0 → 1.1 → 1.2).
Step 4: Update App Information (if needed)
- What’s New in This Version – Describe bug fixes or new features.
- Screenshots/Previews – Update if UI/UX has changed.
- Metadata – Adjust description, keywords, or support URLs if required.
Step 5: Attach the New Build
- Under the Build Section, click Select a Build before you submit.
- Choose the newly uploaded build.
- Save changes.
Step 6: Review Privacy & Compliance
- Confirm your Privacy Policy URL.
- Revisit the App Privacy questionnaire if any new data collection has been introduced.
Step 7: Submit for Review
- Double-check all fields (icon, screenshots, metadata).
- Click Submit for Review.
- Apple’s review team will test the update before releasing it.
⚠️ Common Update Errors
- ❌ Build not visible – Ensure you uploaded via Xcode/Transporter with the correct version.
- ❌ Version mismatch – The version number in App Store Connect must match Xcode.
- ❌ App rejected – Review rejection reason, fix, and resubmit.