How to fix app preview wrong resolution error in App Store Connect

⋅ 3 min read ⋅ Debugging App Store Connect

Table of Contents

When you drag an app preview video into App Store Connect, you might see it get rejected immediately with an error like this.

The dimensions of one or more of your files don't match the requirements for this device.

Sometimes the upload dialog simply refuses the file without much explanation. Either way, the cause is the same: your video resolution is not one of the exact sizes App Store Connect accepts.

In this article, we will learn which resolutions App Store Connect accepts and how to convert your video to match.

Cause of the problem

App Store Connect does not accept "roughly the right aspect ratio". Each device slot requires an exact pixel resolution, and here is the catch: no device actually records at these resolutions.

For example, an iPhone 16 Pro Max records its screen at 1320×2868, but App Store Connect wants 886×1920 for the iPhone 6.9-inch slot. So a raw screen recording will never pass, no matter which device you record on.

You can easily support sarunw.com by checking out this sponsor.

Sponsor sarunw.com and reach thousands of iOS developers.

Accepted app preview resolutions

Here are the resolutions App Store Connect accepts for each device slot.

Device slot Portrait Landscape
iPhone 6.1–6.9 inch 886×1920 1920×886
iPhone 5.5 inch 1080×1920 1920×1080
iPhone 4.7 inch 750×1334 1334×750
iPad 11–13 inch 1200×1600 1600×1200
iPad 9.7 inch 900×1200 1200×900
Mac 1920×1080
Apple TV 1920×1080
Apple Vision Pro 3840×2160

How to fix the wrong resolution error

You need to scale (and usually crop) your recording to the exact target resolution.

Option 1: ffmpeg

This command scales the video to fill 886×1920, then crops the overflow so the output is exactly the right size:

ffmpeg -i input.mov -vf "scale=886:1920:force_original_aspect_ratio=increase,crop=886:1920" -c:v libx264 -preset slow -crf 18 -r 30 -c:a aac -ar 48000 output.mp4

Replace 886:1920 (in both places) with the resolution of your target slot from the table above.

The tricky part is that modern iPhones have a slightly different aspect ratio than 886×1920, so a naive scale either distorts the video or leaves black bars — both of which can get your preview rejected in review. The scale-then-crop approach above trims a few pixels from the edges instead.

Option 2: App Preview Converter (one click)

I built a Mac app that handles all of this for you: App Preview Converter.

You drop in your recording, pick the device slot (every slot in the table above is a built-in preset), and choose how to fit the video — fill or letterbox. The app exports a file with the exact resolution App Store Connect expects, and at the same time fixes everything else that can get your upload rejected:

  • Constant 30 fps frame rate.
  • Duration trimmed to the 15–30 second window.
  • A silent audio track added if your recording has none.
  • H.264 in an accepted container.

You can easily support sarunw.com by checking out this sponsor.

Sponsor sarunw.com and reach thousands of iOS developers.

Read more

You can find the full specification for every device in App Store Connect Help.


Read more article about Debugging, App Store Connect, or see all available topic

Enjoy the read?

If you enjoy this article, you can subscribe to the weekly newsletter.
Every Friday, you'll get a quick recap of all articles and tips posted on this site. No strings attached. Unsubscribe anytime.

Feel free to follow me on Twitter and ask your questions related to this post. Thanks for reading and see you next time.

If you enjoy my writing, please check out my Patreon https://www.patreon.com/sarunw and become my supporter. Sharing the article is also greatly appreciated.

Become a patron Buy me a coffee Tweet Share
Previous
How to fix app preview video that is too long or too short

App Store Connect only accepts app preview videos between 15 and 30 seconds. Learn how to trim your recording to fit without re-editing everything.

Next
How to fix "The frame rate of your app video preview is too high" error

App Store Connect rejects app preview videos that are recorded at 60 fps. Learn why this happens and how to convert your video to 30 fps.

← Home