Guideline 2.1

Guideline 2.1 - App Completeness: Missing App Icon

Low SeverityEasy Fix0 Reports

Our Take

Your app's AppIcon.appiconset has no actual image files. Apple requires a 1024×1024 App Store icon at minimum, and device-resolution icons for the home screen.

Resolution Guide

01

Create a 1024×1024 App Store icon

This is the most important icon. It must be a PNG, no transparency, no rounded corners (Apple applies the mask automatically). Use sRGB or Display P3 color space.

02

Add icon images to your asset catalog

Open Assets.xcassets/AppIcon.appiconset/ in Xcode. Drag your 1024×1024 image into the App Store slot. Xcode 15+ with a single-size icon configuration will auto-generate all device sizes from this one image.

03

Update Contents.json

If using the legacy multi-size format, ensure each entry in Contents.json has a "filename" value pointing to an actual image file in the same directory. Empty filename values mean no icon is assigned.

04

Verify all required sizes exist

For iOS, you need at minimum: 1024×1024 (App Store), 180×180 (@3x iPhone), 120×120 (@2x iPhone), 167×167 (@2x iPad Pro), 152×152 (@2x iPad). Xcode will warn about missing sizes.

05

Test on a real device

Build and install on a physical device. Verify the icon appears on the home screen with proper resolution.

Prevention:

  • Set up the app icon in the first commit of any new project
  • Use a tool like AppIcon.co to generate all sizes from a single image
  • Add an Xcode build phase script that verifies icon files exist
  • Community Solutions · 0

    Sign in to share your solution.

    More Guideline 2 (Performance) rejections

    View all Guideline 2 rejections