Fix Missing iPad App Icon in React Native iOS (Xcode Validation Error 152x152 / 167x167)

Fix Missing iPad App Icon in React Native iOS (Xcode Validation Error)



If you're submitting a React Native iOS app and encounter errors like:

Missing required icon file.
The bundle does not contain an app icon for iPad of exactly '152x152' pixels
The bundle does not contain an app icon for iPad Pro of exactly '167x167' pixels

This issue can be confusing — especially when your project already shows iPad support in Xcode.

🔍 The Confusing Part

In Xcode, you may already see:

  • iPad orientation settings enabled
  • Deployment Info showing iPhone + iPad

However, when opening Assets.xcassets → AppIcon, there are no iPad icon slots.

This leads to App Store validation failure.

🧠 Root Cause

This is caused by a mismatch between:

  • Xcode project settings (which support iPad)
  • Asset catalog configuration (which may still be iPhone-only)

In many React Native projects, the default AppIcon set is created without iPad slots, even when the app later enables iPad support.

✅ The Fix (Cleanest Solution)

Recreate the AppIcon asset set:

  1. Open Assets.xcassets
  2. Delete the existing AppIcon
  3. Right-click → New App Icon
  4. Name it AppIcon

The new AppIcon will automatically include:

  • iPad icon slots (152x152)
  • iPad Pro icon slots (167x167)

🖼️ Required Icons

You must provide at least:

  • 152 × 152 (iPad)
  • 167 × 167 (iPad Pro)

Drag the corresponding PNG files into the slots.

⚠️ Important Check

Make sure your project supports iPad:

Build Settings → Targeted Device Family = 1,2

Where:

  • 1 = iPhone
  • 2 = iPad

🚀 Alternative (If You Don’t Support iPad)

If your app is iPhone-only, you can disable iPad support:

Targeted Device Family = 1

And optionally in Info.plist:

<key>UIDeviceFamily</key>
<array>
  <integer>1</integer>
</array>

This removes the requirement for iPad icons entirely.

💡 Why This Happens in React Native

React Native templates sometimes lag behind Xcode updates. The default asset catalog may not fully align with modern iPad requirements, leading to validation errors during App Store submission.

✅ Final Result

After recreating the AppIcon and adding iPad icons:

  • Validation passes
  • Archive uploads successfully

This fix takes less than 2 minutes but can save hours of debugging.

❤️ Support This Blog


If this post helped you, you can support my writing with a small donation. Thank you for reading.


Comments

Popular posts from this blog

fixed: embedded-redis: Unable to run on macOS Sonoma

Copying MDC Context Map in Web Clients: A Comprehensive Guide

Reset user password for your own Ghost blog