iOS App Icon Generator — Requirements, Dark Mode & Xcode Export Guide (2026)

Generating an iOS app icon involves more than producing a good-looking square image. Apple has specific technical requirements that cause common rejections, Xcode has a specific asset catalog format that must be followed, and iOS 18 introduced dark mode and tinted icon variants that change the complete workflow. This guide covers all of it.

Whether you are using a dedicated AI icon generator, a general image model, or designing in Figma, the export and submission process is the same — and the requirements are stricter than most developers expect the first time through.

iOS App Icon Requirements in 2026

Apple's icon requirements changed significantly with Xcode 14 (released 2022) and again with iOS 18 (released 2024). Here is the current state:

The most important rule: Apple's system applies the squircle mask (continuous curvature rounded rectangle) automatically on every device and context. You submit a perfect square. Apple handles the shaping. If you add rounded corners to your artwork, iOS will round those already-rounded corners again, producing a visually incorrect double-rounded appearance.

Dark Mode and Tinted Icons: The New iOS 18 Workflow

iOS 18 introduced three icon variants that users can switch between in Settings → Wallpaper & Style:

• Standard (Light) icon. The traditional icon — what you have always submitted. Displayed by default and on all iOS versions before 18. This is the only required variant.
• Dark icon. An alternative icon designed for dark mode contexts. Typically an inverted or darker version of your standard icon with lighter elements on a dark background. Displayed when the user has "Automatic" appearance selected and the system switches to dark mode, or when the user explicitly selects "Dark" icon appearance.
• Tinted icon. A monochrome-tinted version of your icon that adapts to the user's wallpaper color. Apple applies the tint automatically if you provide the tinted variant — typically a grayscale or single-color version of your icon that works well with arbitrary tint colors.

All three variants are submitted through Xcode — the dark and tinted variants go into the same AppIcon asset catalog as the standard icon. In Xcode 16, the asset catalog has explicit slots for all three. If you do not provide dark and tinted variants, Apple uses your standard icon for all three modes (with an automatic tint applied for the tinted mode, which often looks poor — another reason to provide your own).

For the dark variant: design it on a dark background (deep grey or black) with light elements. Keep the same focal symbol as your standard icon — just inverted in luminosity. The recognition should be instant even when the icon looks significantly different in color.

For the tinted variant: create a version of your icon where all color information is replaced with a single dark grey or near-black tone. Think of it as a silhouette or stamp version of your standard icon. Apple will then apply the user's wallpaper-derived tint color over this grayscale base.

Understanding the Xcode AppIcon Asset Catalog

Inside your Xcode project, the app icon lives in Assets.xcassets as an AppIcon.appiconset folder. This folder contains:

• The icon image files (PNG files at various sizes)
• A Contents.json file that tells Xcode which image to use at which size and context

With Xcode 14 and the single-size approach, a minimal Contents.json looks like this:

{
  "images": [
    {
      "filename": "AppIcon-1024.png",
      "idiom": "universal",
      "platform": "ios",
      "size": "1024x1024"
    }
  ],
  "info": {
    "author": "xcode",
    "version": 1
  }
}

With iOS 18 dark and tinted variants, the asset catalog expands to include additional entries:

{
  "images": [
    {
      "filename": "AppIcon-1024.png",
      "idiom": "universal",
      "platform": "ios",
      "size": "1024x1024"
    },
    {
      "appearances": [{"appearance": "luminosity", "value": "dark"}],
      "filename": "AppIcon-1024-Dark.png",
      "idiom": "universal",
      "platform": "ios",
      "size": "1024x1024"
    },
    {
      "appearances": [{"appearance": "luminosity", "value": "tinted"}],
      "filename": "AppIcon-1024-Tinted.png",
      "idiom": "universal",
      "platform": "ios",
      "size": "1024x1024"
    }
  ],
  "info": {"author": "xcode", "version": 1}
}

Purpose-built iOS icon generators like WhixFrame export this complete folder structure, including the correctly formatted Contents.json, so you can drag it directly into Xcode without editing any JSON. If you are using a general resizer or designing in Figma, you will need to create the Contents.json manually or use AppIcon.co which generates it for you.

Common iOS Icon Rejection Reasons (and Fixes)

• Alpha channel detected in App Store icon. App Store Connect will reject the upload with a specific error: "The app icon in the iOS app bundle must not be transparent." Fix: open the PNG in Preview (Mac), export as PNG, check "Remove alpha channel" in the export options. Or re-export from your design tool with a solid background color.
• Rounded corners visible in the icon preview. You pre-applied rounded corners to the artwork before submitting. iOS applies its mask on top, creating a double-rounded look. Fix: remove the rounding from your source design and submit a perfect square. The squircle shape is applied by iOS — trust the system.
• Icon imitates an Apple system app or interface element. An icon that looks like Settings, Safari, Maps, or any other built-in iOS app is rejected under Guideline 4.1 (spam) or Guideline 2.3 (accurate metadata). Fix: ensure your icon is distinctive and not derivative of any system icon. If your icon happens to use a similar symbol (gear, magnifying glass, map pin), change the color, weight, and composition to be clearly unique.
• Icon contains trademarked material you do not own. A recognizable brand logo, character, or symbol from another company. Fix: remove the third-party element entirely. Even artistic interpretations of trademarked material can cause rejection.
• Icon does not match the app's function. An icon showing a camera for an app that has no camera functionality. Apple reviewers can and do reject icons that they consider misleading about the app's purpose. Fix: your icon's visual metaphor should directly relate to what the app actually does.
• Resolution too low. Submitting at less than 1024×1024px. App Store Connect will reject any icon below this threshold. Fix: always work at 1024px minimum and export at 1024px. Upscaling a small icon to 1024px produces visible quality degradation — generate at 1024px from the start.

Step-by-Step: Generate and Export an iOS Icon Set

1. Generate your icon artwork at 1024×1024px. Use WhixFrame, Recraft AI, ChatGPT, or design in Figma. If using an AI generator, prompt for: bold, simple, centered focal symbol, solid or simple gradient background, no text, no fine detail, generous padding from all edges. The padding matters — system masks clip the corners, and OEM notification badges sometimes appear at icon corners.
2. Preview at small sizes before committing. Upload to the free WhixFrame icon size previewer. Check the 40px preview carefully — that is the size at which your icon appears in App Store search results and on some notification badges. If any detail is lost or the icon looks unclear at 40px, go back and simplify.
3. Remove any alpha channel from the 1024px PNG. Open in Preview (Mac) → Export → uncheck "Alpha." Or in Photoshop: Flatten Image before exporting as PNG. Or check that your design tool is exporting with a solid background layer.
4. Create dark and tinted variants (iOS 18). Dark variant: take your standard icon, invert the lightness (dark background, light symbol), keep the same visual identity. Tinted variant: desaturate to grayscale, keep the same silhouette shape. Both still at 1024×1024px PNG, still no alpha channel.
5. Generate the Xcode asset catalog. If using WhixFrame: download the iOS icon export — it includes the AppIcon.appiconset folder with the correct Contents.json. If using AppIcon.co: upload your 1024px source, download the Xcode-compatible ZIP. If using any other tool: use AppIcon.co for this step, as it generates the correct folder structure.
6. Add to Xcode. In Xcode, open Assets.xcassets. Delete the existing AppIcon entry. Drag the downloaded AppIcon.appiconset folder into Assets.xcassets. Xcode automatically reads the Contents.json and shows your icon correctly.
7. Build and run on a real device or simulator. Check the icon on the home screen, in the app switcher, in Settings, and (if you have notification support) in the notification center. Each context renders the icon at a different size — they should all look clear and intentional.
8. Upload to App Store Connect. Archive the app, upload via Xcode Organizer or Transporter. App Store Connect automatically validates the icon as part of the binary submission. If there is an alpha channel issue, you will see a specific validation error before the upload completes.

Testing Your Icon Before Submitting

Test your icon in these specific contexts before submitting — each reveals different things:

• Home screen among real apps. Does it stand out from or blend into your other installed apps? Does the color or style clash with neighboring icons? Your users will see this icon next to dozens of other apps every day — it needs to hold its own in a crowded grid.
• App Store search result. App Store search shows your icon next to competitors in a small, horizontal format. Take a screenshot of a search results page, place your icon in a similar context, and evaluate whether it is distinguishable at that scale.
• Dark mode home screen. If you are providing a dark mode icon variant, test it in dark mode specifically. The contrast and legibility requirements change significantly against a dark background.
• Small notification badge context. On iOS, app icons appear on notification banners at roughly 40×40pt. Run a test notification in the simulator and check that the icon communicates clearly at that size.
• Settings app entry. Your app appears in iOS Settings with a 60pt icon. Legibility at this size is typically fine, but asymmetric or very detailed icons can look odd in the Settings list context.

The WhixFrame icon previewer shows your icon rendered at every one of these sizes with accurate dimensions, without requiring you to build and run a test app. Use it before committing to final artwork.

Frequently Asked Questions