Why this happens
App Store Connect can reject an upload with ITMS-90717: Invalid App Store Icon when the App Store icon in the asset catalog contains an alpha channel. The full message says the icon “can’t be transparent nor contain an alpha channel.”
An image can look completely opaque and still contain an alpha channel. For this validation error, an opaque appearance alone is not enough: the submitted icon must also be saved without that channel.
In projects that generate platform assets, the icon you edited may not be the one included in the archive. A generator can also produce a PNG with an alpha channel even when the original image looked correct. Check both the source and the generated App Store icon before uploading again.
How to fix it
1. Export the App Store icon without alpha
The accepted solution is to export a new copy of the 1024 × 1024 icon in Preview with the alpha channel disabled, then replace the image used by the project.
- Find the 1024 × 1024 App Store icon image used by your app. In Xcode, inspect the app icon set in the asset catalog to identify the assigned image.
- Open the image in Preview.
- Choose File > Export and select PNG as the format.
- If the export options show an Alpha checkbox, clear it. Save the exported image with a new name so you can compare it with the original.
- Replace the App Store icon image in the asset catalog with the exported copy.
- Create a new archive in Xcode, then validate or upload that new archive to App Store Connect.
The Alpha option may not be available or may behave differently in some Preview versions. If the exported file still has alpha, try duplicating the image in Preview and saving the duplicate without alpha, or use the ImageMagick method below.
If your icon actually has transparent areas, first give those areas the intended background color in an image editor. Removing the channel can change how formerly transparent pixels look, so open the exported file and check its appearance before submitting it.
2. Check whether the PNG still has alpha
You can inspect the image from Terminal with the macOS sips tool. Replace the example path with the path to your exported icon:
sips -g hasAlpha /path/to/AppStoreIcon.png
Look for the hasAlpha value in the output. If it reports yes, the file still has an alpha channel, even if Preview shows a solid-looking icon. Export it again without alpha or use the next method, then run the check on the new file.
Check the image actually assigned to the app icon set, not just another copy on your desktop. If you replace the file in a generated project, check that copy too. A correct source image does not guarantee that a later generation step preserved the same channel information.
3. Use ImageMagick if Preview does not remove the channel
ImageMagick provides another way to remove alpha. If you already use Homebrew, install ImageMagick with:
brew install imagemagick
For an icon that is already visually opaque, make a separate output file:
magick /path/to/AppStoreIcon.png -alpha off /path/to/AppStoreIcon-no-alpha.png
Then inspect the result:
sips -g hasAlpha /path/to/AppStoreIcon-no-alpha.png
Open the output image to make sure it still looks right. Replace the assigned App Store icon with that output, create a new archive, and validate or upload it.
If the input has visible transparent areas, composite it over the background you want instead of simply turning alpha off. For example, this command uses white:
magick /path/to/AppStoreIcon.png -background white -alpha remove -alpha off /path/to/AppStoreIcon-no-alpha.png
Choose a background that suits your design; white is only an example. Check the exported image at full size before using it.
One solution for generated projects removes alpha from every PNG in a resources folder. Avoid doing that indiscriminately: other images may need transparency. Apply the change to the App Store icon, or to a dedicated set of icon source files after reviewing them.
4. Check generated assets and rebuild the archive
If the error returns after you replace the icon, trace where the build gets its image. In an Ionic project, for example, the generated iOS asset catalog may contain its own 1024 × 1024 PNG. The source material describes one such file under platforms/ios/.../Images.xcassets/Appicon.appiconset/.
Use this sequence to avoid fixing only a temporary copy:
- Identify the original icon supplied to the project’s asset-generation process.
- Remove its alpha channel and verify it with
sips. - Regenerate the platform assets using the workflow for your project.
- Find the generated App Store icon and run the same
sipscheck on it. - If the generated file still reports alpha, correct the generation step or replace that generated icon with a verified no-alpha PNG. Keep in mind that regeneration may overwrite a manual replacement.
- Confirm the corrected icon is assigned in the Xcode asset catalog, then create and upload a fresh archive.
An existing archive is a snapshot of an earlier build. Changing an icon in the project does not update an archive you already created, so retrying the old archive will not include your fix.
How to prevent it
- Check the 1024 × 1024 App Store icon for an alpha channel before archiving, even when it looks opaque.
- Keep a verified no-alpha source icon for your asset-generation workflow.
- Recheck generated icons after changing or rerunning that workflow.
- Review the exported image visually, especially if the original used transparency.
- Create a new archive after changing the asset catalog.
FAQ
Why is an opaque-looking icon rejected?
The PNG can have an alpha channel even when every visible pixel appears opaque. The error rejects an icon that contains the channel as well as one with visible transparency.
Why does the error persist after I replace the icon?
You may have changed a source image while the app uses a generated copy, or you may be uploading an archive created before the replacement. Check the generated asset, confirm its assignment in Xcode, and create a new archive.
Should I remove alpha from every PNG in the project?
No. Other images may rely on transparency for their appearance. Limit the change to the App Store icon or to icon files you have reviewed for that purpose.
Parts of this guide are adapted from content licensed under CC BY-SA 3.0; this article is shared under the same license.
