Why am I seeing "The dimensions of one or more screenshots are wrong"?

When uploading screenshots in App Store Connect, you may encounter this error:

The dimensions of one or more screenshots are wrong. Learn More.

Depending on the display size slot, the expanded message also lists the sizes that slot accepts, for example:

Screenshots dimensions should be: 1242 × 2688px, 2688 × 1242px, 1284 × 2778px or 2778 × 1284px

(That particular list means you’re uploading into the iPhone 6.5" slot.) Some older App Store Connect screens phrase it as “The dimensions of one or more screenshots are incorrect.” It’s the same problem.

This typically happens when you manually upload screenshots that don’t match the size slot you’re uploading to, or when you mix screenshot sizes from different display classes.

What causes this

App Store Connect groups screenshots by display size (e.g. 6.9" Display, 6.5" Display, 13" Display). Each display size slot accepts only specific pixel dimensions. If you upload a screenshot that was rendered for a different display size, the upload will be rejected.

Common scenarios:

• Uploading iPhone 6.9" screenshots into the 6.5" slot (or vice versa). For example, a 1320 x 2868 screenshot belongs to the 6.9" display slot, not the 6.5" slot which expects 1284 x 2778 or 1242 x 2688.
• Replacing existing screenshots with a different size. If you previously uploaded 6.5" screenshots and now try to upload 6.9" screenshots into the same slot, the dimensions won’t match.
• Exporting at the wrong scale. Screenshots exported at 1x instead of the native resolution (typically 2x or 3x) will have incorrect dimensions.

How to fix it

1. Check which display size slot you’re uploading to. In App Store Connect, each display size has its own section. Make sure your screenshot dimensions match the slot you’re targeting.
2. Verify your screenshot dimensions. You can check dimensions in Finder by selecting the file and pressing Cmd + I, or by opening it in Preview and checking Tools > Show Inspector.
3. Re-export at the correct size. If using ButterKit, ensure your artboard is configured for the correct device. ButterKit automatically exports at the correct pixel dimensions for each device type.
4. Use ButterKit’s direct upload. The easiest way to avoid dimension mismatches is to use ButterKit’s Upload to App Store Connect feature, which automatically places screenshots in the correct display size slots.

Skip the hassle: let ButterKit upload for you

You can bypass this error entirely by using ButterKit’s built-in Upload to App Store Connect feature. Instead of manually dragging files into the correct slots in App Store Connect, ButterKit exports each screenshot at the exact pixel dimensions required and uploads them directly to the right display size slot via the App Store Connect API. No more guessing which size goes where.

Apple’s accepted screenshot sizes

Each platform and display size has specific pixel dimensions that App Store Connect accepts. For every accepted size across iPhone, iPad, Mac, Apple Watch, Apple TV, and Vision Pro (including which ones are actually required), see our App Store Screenshot Sizes (2026) reference, or Apple’s official documentation:

Screenshot specifications (Apple Developer)

Here are the most common iPhone sizes for quick reference:

Does this happen for in-app purchase screenshots too?

Yes. The same dimensions error appears when uploading the review screenshot for an in-app purchase or subscription. Those use their own required size (640 × 920 pixels for iPhone), which is separate from your marketing screenshot sizes above, so a regular App Store screenshot will always be rejected there.