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:
- Open
Assets.xcassets - Delete the existing
AppIcon - Right-click → New App Icon
- 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
Post a Comment