# Guideline 2.1 - App Completeness: Missing App Icon

**Guideline:** 2.1 · **Store:** Apple App Store · **Risk:** low · **Difficulty:** easy

Canonical URL: https://appstorereject.com/rejections/apple/2/guideline-21-app-completeness-missing-app-icon

## Description

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 steps

1. **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.

2. **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.

3. **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.

4. **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.

5. **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

---
*Machine-readable source: https://api.appstorereject.com/api/rejections/detail?slug=guideline-21-app-completeness-missing-app-icon*