App Store Reject

Guideline 2.1

Guideline 2.1 - App Completeness: Missing App Icon

Low RiskEasy0 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