Resolving the “Invalid App Store Icon” Error

Resolving the "Invalid App Store Icon" Error

28 February 2025 Stephan Petzl Leave a comment Xcode

Encountering the “Invalid App Store Icon” error when submitting an app to iTunes Connect can be a frustrating experience for developers. This error typically arises when the app’s icon in the asset catalog is transparent or contains an alpha channel. Below, we provide a comprehensive guide to resolving this issue effectively.

Understanding the Error

The error message indicates that the App Store icon should not have any transparency or alpha channels. Essentially, your icon should be a solid, square image without any semi-transparent or invisible areas.

Step-by-Step Solutions

Using Preview on macOS

  1. Open the App Store icon (1024×1024) in the Preview app.
  2. Go to the File menu and select Export.
  3. In the export options, ensure that the Alpha channel is unchecked.
  4. Save the new image and replace the existing icon in your project with this one.
  5. Validate and upload your app again.

Note: If you’re using macOS High Sierra, this method may not work. Consider using a lower version of macOS, or alternative image editing software.

Using ImageMagick on macOS

  1. Install ImageMagick by running: brew install imagemagick
  2. Remove the alpha channel from all images in your resource folder by executing: find ./resources/ -name "*.png" -exec convert "{}" -alpha off "{}" \\;
  3. Rebuild and resubmit your application.

For Flutter Developers

If you are using Flutter, you can resolve this issue by modifying your pubspec.yaml file:

flutter_icons:
  android: false
  ios: true
  remove_alpha_ios: true
  image_path: 'assets/images/icon.png'

Then, run the following commands:

  • flutter pub get
  • flutter pub run flutter_launcher_icons:main

This will generate iOS icons without an alpha channel, allowing for successful app submission.

Additional Resources

For more detailed instructions on handling errors in Swift, you can refer to our guide on Handling Errors in Swift.

Enhancing Your Development Workflow with Repeato

While managing app icon issues can be a hurdle, ensuring your app functions correctly across different platforms is crucial. Repeato, a no-code test automation tool, can significantly streamline this process. Repeato leverages computer vision and AI to create, run, and maintain automated tests for iOS, Android, and web apps effortlessly. Its fast test recording, editing, and execution capabilities make it an excellent alternative to other tools like Katalon, especially for those seeking a more flexible and efficient solution. By supporting data-driven and keyword-driven testing, Repeato ensures your app is thoroughly tested and ready for deployment.

Explore how Repeato can enhance your testing strategies by visiting our Getting Started page.

Check it out!

Like this article? there’s more where that came from!

Repeato

Documentation

Support

Legal

Repeato Reviews