App Store Connect rejects a screenshot because it has transparency
Images can't include alpha channels or transparencies.Short answer
App Store Connect does not accept screenshots that carry an alpha channel or transparent pixels. Check the file with sips, then re-export it as a flat image: convert it to JPEG, or save the PNG again with transparency turned off. Also confirm the pixel size matches one of the sizes Apple lists for that device.
Fix it fast
1Find out which cause you have
Ask macOS whether the file has an alpha channel and what its pixel size is. Run it on the screenshot App Store Connect refused.
sips -g hasAlpha -g pixelWidth -g pixelHeight screenshot.png2Match what you see, then jump to its fix
- 1
hasAlpha: yes in the sips output. Simulator captures, design-tool exports and device-frame mockups often carry one even when nothing looks transparent.The screenshot has an alpha channelFix - 2
The upload is refused or the slot stays empty even though hasAlpha: noThe file type or pixel size is not one Apple listsFix
- 1
What does the error look like?
Images can't include alpha channels or transparencies.
Cause 1 of 2
The screenshot has an alpha channel
1Check
Apple's screenshot specification says plainly that images can't include alpha channels or transparencies. If sips reports hasAlpha: yes, that is the reason for the refusal.
sips -g hasAlpha screenshot.png2Fix
Write a flat copy. Converting to JPEG is the quick way, because JPEG has no alpha channel, and JPEG is an accepted upload format. If you want to stay in PNG, export again from your design tool with the transparency or alpha option switched off.
sips -s format jpeg screenshot.png --out screenshot.jpg3Verify
The new file reports no alpha, then uploads.
sips -g hasAlpha screenshot.jpgConfirmed by developer.apple.com
Cause 2 of 2
The file type or pixel size is not one Apple lists
1Check
Screenshots must be .jpeg, .jpg or .png, and the pixel size has to match one of the sizes in Apple's table for that device class. For iPhone the required slot is a display with Dynamic Island (medium), for example 1179 x 2556 or 1206 x 2622 in portrait.
sips -g pixelWidth -g pixelHeight screenshot.png2Fix
Re-export from your design tool at a size from Apple's table, or capture again on a device of a listed size. If your layout is the same across sizes, Apple says you only need the highest required resolution and App Store Connect scales it down.
sips -g pixelWidth -g pixelHeight exported.png3Verify
Width and height match a size in the table, hasAlpha is no, and the upload is accepted.
sips -g pixelWidth -g pixelHeight -g hasAlpha screenshot.pngConfirmed by developer.apple.com
How do I stop it coming back?
- Export store screenshots from your design tool with a flat background and no transparency option.
- Run a quick sips check on the whole screenshots folder before you open App Store Connect.
- Keep one folder per device size, named by the pixel size, so the wrong size is obvious.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Related fixes
Mobile apps
Cannot change the App Privacy answers in App Store Connect
Publish Your App Privacy Responses?
Only the Account Holder, Admin and App Manager roles can answer the App Privacy questions.
2 causes, each with a fixMobile apps
App record creation fails because you lack permission
You cannot add a new app in App Store Connect as a Developer or limited user
Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.
3 causes, each with a fixMobile apps
You cannot find the button to pull your app back from review
No 'remove this version from review' message appears on the version page
There is no button called Reject Binary.
3 causes, each with a fixMobile apps
Your Apple Account cannot sign in to App Store Connect
Sign-in to App Store Connect is refused for an account that should have access
App Store Connect does not open to every Apple Account.
3 causes, each with a fixMobile apps
Apple rejected the app under Guideline 4.3, Design: Spam
Guideline 4.3(b) - Design - Spam
Guideline 4.3 is Apple's duplicate rule.
5 causes, each with a fixMobile apps
CMake cannot find a C compiler on macOS
CMake Error: No CMAKE_C_COMPILER could be found.
CMake looks for a compiler when project() runs.
3 causes, each with a fix