How to fix "The dimensions of one or more screenshots are wrong" in App Store Connect

How to fix it

1. 1

   Read the file's real pixel dimensions

   Do not trust the Finder preview or the name of the export preset. Read the pixels.

   # macOS, no install needed
   sips -g pixelWidth -g pixelHeight screenshot.png
   
   # ImageMagick, any platform
   magick identify -format "%wx%h\n" screenshot.png
   

   Run it across the whole folder. The error says "one or more", so a set of ten can fail on a single file while the other nine are correct.

2. 2

   Match the size to the slot you are uploading to

   Apple lists exact pairs per display slot. These are the ones an indie release normally touches, verified against Apple's specifications page:

   • iPhone 6.9-inch: 1260 x 2736, 1290 x 2796, or 1320 x 2868 portrait, and the same pairs transposed for landscape
   • iPhone 6.5-inch: 1284 x 2778 or 1242 x 2688 portrait
   • iPad 13-inch: 2064 x 2752 or 2048 x 2732 portrait

   The common near-miss is uploading a 6.5-inch file (1284 x 2778) into the 6.9-inch slot. Both are tall iPhone screenshots, both look right, and only one is accepted there.

3. 3

   Re-export rather than resize

   Scaling a finished image to a new size changes its aspect ratio unless the two sizes happen to share one, and the sizes above do not. Interpolation also softens text, which is the part of a screenshot that has to survive being shown at thumbnail scale.

   Go back to the source and export at the target size. If the source is a design file, set the artboard to the exact pixel pair first. If the source is a device capture, capture on a simulator set to a device in that slot.

4. 4

   Confirm before you re-upload

   Re-run the size check from step one over the exported folder and compare every line against the pair you targeted. App Store Connect validates on upload, so a second wrong file costs another round trip.

   for f in *.png; do
     printf "%s " "$f"
     magick identify -format "%wx%h\n" "$f"
   done