Fix "The dimensions of one or more screenshots are wrong"

By Alistair CooperPublished October 27, 2026

Facts checked against the stores’ own documentation on October 26, 2026.

Share
An App Store Connect style upload well holding three screenshots of Bracket, a fictional learn-to-code app made in Screenodon, while a fourth file at 1320 × 2868 is refused under the error “The dimensions of one or more screenshots are wrong”. Labels note that the slot takes 1206 × 2622 or 1179 × 2556.

The short answer

The message means at least one file's exact pixel size isn't one Apple lists for the slot you dropped it into.

  • Close doesn't count: the required iPhone slot takes only 1206 x 2622 or 1179 x 2556 in portrait.
  • So a 1205 x 2622 file fails, and so does a 1320 x 2868 Pro Max capture.
  • Check each file's pixel size, then re-export or recapture at a listed size.
On this page

What "the dimensions of one or more screenshots are wrong" means

Apple doesn't document the message itself, but its screenshot specifications explain it. Each display class has a short list of exact pixel sizes, with portrait and landscape versions for iPhone and iPad, and you drag files into the slot (Apple calls it a well) for one device size at a time. A file with the right aspect ratio but the wrong pixel count still doesn't match.

The message says "one or more", so check every file in the batch.

This is an upload check, not App Review. For problems review raises later, see why App Store screenshots get rejected.

One slot, five files

Bracket is a fictional coding app. The slot takes only the exact sizes Apple lists for its class.

Why your screenshot is the wrong size

The file is a pixel or two off

A hand crop or a canvas size typed from memory can leave you at 1206 x 2621 or 1205 x 2622. The required iPhone class takes only 1206 x 2622 or 1179 x 2556 in portrait, so neither is accepted.

The design tool exported at the wrong scale

Design tools export a frame at a scale you choose. A frame drawn at an iPhone's size in points needs a scale of 3 (an iPad's needs 2); a frame already drawn in pixels needs a scale of 1. Mix them up and the file comes out far too small or far too big.

Worked example

The iPhone 17 Pro's screen is 402 x 874 points at a scale of 3.

  • 402 x 874 frame at a scale of 3: 1206 x 2622, an accepted size.
  • The same frame at a scale of 1: 402 x 874, which fits no class.
  • A 1206 x 2622 frame at a scale of 3: 3618 x 7866, which fits no class either.

One frame, three export scales, drawn to scale

A frame drawn in points needs a scale of 3 for iPhone. A frame already drawn in pixels needs a scale of 1.

The screenshot comes from a different class of device

The phone you captured on decides the class:

  • A Pro Max or Air screenshot in the required slot. The iPhone 18 Pro Max, 17 Pro Max and 16 Pro Max capture at 1320 x 2868, and the iPhone Air at 1260 x 2736. Both are sizes for iPhone with Dynamic Island (large display), a different class, so the required medium display slot refuses them.
  • An "e" model. The iPhone 17e and 16e capture at 1170 x 2532, a size for iPhone with Face ID (medium display), not the required class.
  • An iPhone 11 or XR. Apple lists both under Face ID (large display), which accepts 1284 x 2778 or 1242 x 2688. Their screens are 828 x 1792, which fits no class at all.
  • An iPhone Duo screenshot. Apple's Duo sizes, 1398 x 2034 for the outer display and 2007 x 2853 for the inner, belong only to the iPhone Duo class. The iPhone Duo screenshot guide covers that set.

Apple's model list for every class is in App Store screenshot sizes for every device.

The image was resized or cropped on the way

Messaging apps and some photo services can resize or recompress the images you send through them, so upload the original, not the copy from the chat. A macOS screenshot of the Device Hub or Simulator window has the same problem: it records the window as drawn on your display, not the device's pixels.

Cropping off the status bar breaks the size too. Apple lists "without status bar" sizes only for the 4-inch and 3.5-inch iPhone classes and the 9.7-inch iPad (640 x 1096 next to 640 x 1136, for example).

The orientation doesn't exist for that platform

Every iPhone and iPad class lists landscape sizes too, so 2622 x 1206 is as valid as 1206 x 2622. Mac, Apple TV and Apple Vision Pro sizes are all wider than tall, and Apple Watch sizes are all taller than wide, so a file turned the other way matches nothing.

How to check a screenshot's exact pixel size

On a Mac, sips prints the size in Terminal, plus whether the file has alpha, which Apple's specifications also rule out:

sips -g pixelWidth -g pixelHeight -g hasAlpha screenshot.png

Preview's inspector (Tools > Show Inspector) and Finder's Get Info show the size too. Or drop the file on the checker below, which names the class the size fits and never uploads the file.

Size checker

How to fix the dimensions error

Export at the exact size

Screenodon exports the iPhone set at 1206 x 2622 (and 1320 x 2868 when you ask for it), and its iPad canvas is 2064 x 2752, so there's no frame size or export scale to get wrong. Anywhere else, set the frame to the accepted size, or to the matching point size with an export scale of 3 for iPhone (2 for iPad).

Capture on a simulated device from the right class

Pick a simulated device whose capture is already an accepted size. In Xcode 27.2:

  • iPhone 18 Pro, 17 Pro, 17 or 16 Pro: 1206 x 2622
  • iPhone 16, 15 Pro, 15 or 14 Pro: 1179 x 2556
  • iPad Pro 13-inch (M4 or M5): 2064 x 2752
  • iPad Air 13-inch: 2048 x 2732

Both iPhone sizes are accepted for the required class, iPhone with Dynamic Island (medium display), and those eight iPhones are the models Apple lists for it.

Apple's capture documentation says Device Hub (the Simulator in earlier Xcode releases) saves screenshots "at the full resolution of the simulated or physical device", whatever your Mac's display. Use its Screenshot button, not a macOS screenshot of the window. The rest of the job, from planning the set to uploading it, is in the complete App Store screenshots guide.

Trim a pixel or two

When a file is a pixel or two over, crop it instead of resampling it. sips takes the height first:

sips -c 2622 1206 screenshot.png --out screenshot-fixed.png

Check the result. A file that's short can't be cropped to fit, so export it again.

Check, trim a pixel, check again

macOS Terminal with sips. The output is what sips prints; the file and its path are examples.

What size is an in-app purchase review screenshot?

Any screenshot size your app supports. Apple's In-App Purchase information page asks you to "upload a screenshot that meets any of the screenshot specifications your app supports", so for an iPhone app a 1206 x 2622 screenshot of the item or service on offer works. It goes in the Review Information section, and only App Review sees it. Subscriptions, an in-app purchase type in Apple's docs, follow the same rule. The promotional image is a separate field at 1024 x 1024.

Similar errors with different fixes

  • Alpha channel. Apple's specifications say images "can't include alpha channels or transparencies", even at a correct size. Export without alpha, or save as JPEG. The App Store screenshot requirements checklist covers the other file rules.
  • The 13-inch iPad set is missing. If your app supports iPadOS, Apple requires at least one 13-inch screenshot. An 11-inch capture, such as 1668 x 2420 from an iPad Pro 11-inch (M5), belongs to the 11-inch class and won't satisfy it. See iPad screenshot sizes and when the 13-inch is required.
  • Uploads still in progress. That message is about timing, not size: let each upload finish before you save or submit.

Frequently asked questions

Can I stretch a screenshot to the right size?

Only in proportion, then crop the leftover pixels. Stretching to a different shape squashes your interface, so if the shape is far off, re-export or recapture instead.

Why won't App Store Connect take my iPhone 11 or XR screenshot?

Their screens are 828 x 1792, a size no class accepts, even though Apple lists both under Face ID (large display). Capture on a simulated device from the class you're filling.

Does the DPI setting in the file matter?

Not for screenshots. Apple's screenshot specifications are in pixels and don't mention DPI, and changing the DPI metadata leaves the pixel size as it was. The in-app purchase promotional image is different: Apple asks for 72 dpi there.

Written by

Alistair Cooper

Founder of Screenodon

I’ve spent over ten years shipping iOS apps, from a blank Xcode project to the App Store, on my own and on large teams. At Fender I was a technical lead on Fender Play and worked on apps used by millions of people.

More about me and how I write these guides
Share

Sources

  1. Apple, App Store Connect Help: Screenshot specifications
  2. Apple, App Store Connect Help: Manage your App Store assets
  3. Apple, App Store Connect Help: In-App Purchase information
  4. Apple, App Store Connect Help: View and edit In-App Purchase information
  5. Apple, App Store Connect Help: In-App Purchase types
  6. Apple, App Store Connect Help: Offer auto-renewable subscriptions
  7. Apple Developer Documentation: Capturing screenshots and videos from devices
  8. Apple Developer Documentation: Xcode 27 release notes

Put this into practice on your own set

Start a free account, drop in your raw screenshots, and Screenodon lays out a first draft of the whole set for you to edit. Saving and export at every store size need Pro.

Keep reading