How to Fix “Unknown Error” When Uploading iOS Build

Introduction

When you see an “Unknown Error” while uploading your iOS build, it’s often caused by transparency in your app icon. iOS requires fully opaque icons—any alpha channel will trigger upload failures. This guide explains how to remove transparency and successfully upload your build.

Prepare an Opaque App Icon

1. Open your app icon file in your preferred image editor.
2. Go to File > Duplicate to create a working copy.
3. In the copy, deselect or disable the Alpha checkbox to remove transparency (e.g., in Photoshop’s Channels panel or your editor’s export settings).
4. Save the edited image as a new file (keep it in PNG format if required by your workflow).
   

Update the Icon in Your BuddyBoss App

1. In your WordPress admin, navigate to BuddyBoss App > Branding > Images > App Icon.
2. Upload the new, fully opaque icon file.
3. Click Save Changes to apply the update.
   

Rebuild and Upload

1. Generate a fresh iOS release build using your updated icon.
2. In App Store Connect (or your CI/CD pipeline), upload the new build.
3. Confirm the build processes without the “Unknown Error.”
   

Troubleshooting and FAQs

Q: I still get the same error after correcting the icon. What now?
A: Clear your build cache and rebuild the archive. Ensure no other assets (e.g., launch images) contain transparency.

Q: How can I verify an image has no alpha channel?
A: Open the file in an image editor and confirm there’s no “Alpha” or “Transparency” option enabled. Alternatively, use a tool like pngcheck to inspect the PNG metadata.