App Store Connect
How to fix "The images are not in the right format" in App Store Connect
Verified against Apple, App Store Connect Help on
The images are not in the right format.
How to fix it
Read the real format from the first bytes
Every image format starts with a fixed signature, so the first few bytes tell you what the file actually is regardless of its name.
file screenshot.jpg # PNG image data, 1260 x 2736 <- renamed, not converted # JPEG image data, JFIF standard <- genuinely a JPEGIf
fileis not available, read the bytes directly. A PNG begins89 50 4e 47, a JPEG beginsff d8 ff:xxd -l 4 screenshot.jpgRe-encode instead of renaming
Converting means decoding the pixels and writing them back out in the other format. A rename does neither.
# macOS, no install needed sips -s format jpeg screenshot.png --out screenshot.jpg # ImageMagick, any platform magick screenshot.png -quality 95 screenshot.jpgQuality 90 to 95 is the usual range for store screenshots. Lower starts showing artefacts around text, which is the content that has to stay legible at gallery size.
Decide whether you need JPEG at all
App Store Connect accepts
.jpeg,.jpgand.png. PNG is not the problem on its own.Most people arrive here after hitting the alpha channel error and reaching for a rename as the fix. If that is the sequence you are in, converting to JPEG solves both at once, because JPEG has no alpha channel in the format. Keeping PNG also works as long as you strip the channel properly.
Check the set before uploading again
Run the format check across the folder so a single renamed file does not cost you another round trip.
for f in *; do printf "%s: " "$f" file -b "$f" done
Why this happens
Operating systems present the extension as if it were the format, and for most day-to-day purposes the illusion holds. Preview opens the file either way, the thumbnail renders, and the name says JPEG.
Upload validators do not work from the name. App Store Connect decodes the file, finds a PNG signature where the name promised a JPEG, and refuses it.
This error most often arrives second rather than first. The upload is refused for carrying an alpha channel, renaming the file looks like the fastest fix, and the rename produces this message instead. Both are solved by one real conversion.
Sources
- Screenshot specifications | Apple, App Store Connect Help (primary)
Go deeper
The rule behind it
Related guides
- How to fix "Images can't include alpha channels or transparencies" in App Store ConnectThe alpha channel is a property of the file, not of anything you can see, so an image with no visible transparency still carries it. Re-encode the file as JPEG, or strip the channel from the PNG with ImageMagick. Renaming the extension does not change the bytes and produces a different error.
- How to fix "The dimensions of one or more screenshots are wrong" in App Store ConnectApp Store Connect accepts a fixed list of pixel sizes per display slot, not a range or an aspect ratio. Read the file's real pixel dimensions, find the exact pair on Apple's list for the slot you are uploading to, and re-export at that size. Scaling an existing file to fit almost always lands one pixel off.