Back to LaunchSpec

Error: The dimensions of your app preview are wrong

Fix: Wrong Video Resolution

App Store Connect rejection

What this error means

App Store Connect requires preview videos at exact pixel dimensions for each target device. Not close, not approximate — exact. Even 1 pixel off in either direction causes an immediate rejection.

The error appears after uploading your preview video to the Media tab in App Store Connect. Apple validates the video dimensions against the expected resolution for the device size you're targeting. If they don't match, the upload fails silently or shows a dimensions error.

Required resolutions

Every device has a specific resolution that App Store Connect expects. Portrait and landscape are separate dimensions — you can't simply rotate the same video.

DevicePortraitLandscape
iPhone 6.9"886 × 19201920 × 886
iPhone 5.5"1080 × 19201920 × 1080
iPhone 4.7"750 × 13341334 × 750
iPad 13"1200 × 16001600 × 1200
iPad 9.7"900 × 12001200 × 900
Mac1920 × 1080
Apple TV1920 × 1080
Apple Vision Pro3840 × 2160

Why it happens

Screen recording captures at native resolution

Your device’s native screen resolution is not the same as what App Store Connect expects. For example, an iPhone 15 Pro Max records at 2796 × 1290 natively, but the App Store requires 1920 × 886.

Editing software adds letterboxing

When you place a recording into a timeline with different dimensions, editors add black bars to fill the gap. This changes the effective resolution of the exported file.

Export settings alter dimensions

Many editing tools have preset export resolutions (1080p, 4K) that don’t match any App Store requirement. The output ends up at 1920 × 1080 when you needed 886 × 1920.

Retina Macs capture at 2x

macOS screen recordings on Retina displays capture at double the logical resolution. A 1920 × 1080 display records as 3840 × 2160, which is the wrong size for a Mac App Store preview.

The manual fix

You can fix the resolution yourself using FFmpeg from the command line. This command scales the video to fit within the target dimensions and pads any remaining space:

ffmpeg -i input.mp4 -vf "scale=886:1920:force_original_aspect_ratio=decrease,pad=886:1920:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -profile:v high -c:a aac output.mp4

You need to change the resolution values for each target device. And this only fixes resolution — you still need the correct codec, frame rate, audio format, and duration to pass App Store Connect's validation.

The easy fix

LaunchSpec converts your screen recording to the exact resolution, codec, frame rate, audio format, and duration that App Store Connect requires. Pick your device, upload your video, and get a compliant file back. Every technical spec is handled automatically — no command line, no guessing dimensions, no re-uploads.

Fix Your Video Now

Related

Stop fighting with resolutions

Upload your screen recording. Pick the device. Get a video that passes App Store Connect on the first try.

Convert Now