Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

App Store Connect rejects a screenshot because it has transparency

ErrorImages 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.

  • Applies to App Store Connect (Nov 2026), macOS 15, Xcode 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 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.png
  2. 2Match what you see, then jump to its fix

    1. 1hasAlpha: 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. 2The upload is refused or the slot stays empty even though hasAlpha: noThe file type or pixel size is not one Apple listsFix

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.png

2Fix

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.jpg

3Verify

The new file reports no alpha, then uploads.

sips -g hasAlpha screenshot.jpg

Confirmed by developer.apple.com

Did this fix it?

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.png

2Fix

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.png

3Verify

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.png

Confirmed by developer.apple.com

Did this fix it?

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

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 fix

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.