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

⋅ 3 min read ⋅ Debugging App Store Connect
Table of Contents

When you upload an app preview video to App Store Connect, you might come across this error.

The frame rate of your app video preview is too high.

This is probably the most common error you will hit when uploading an app preview, and the cause is not obvious because the video plays perfectly fine on your Mac.

In this article, we will learn what is causing this error and how to fix it.

Cause of the problem

App Store Connect only accepts app preview videos with a frame rate of 30 fps or lower.

The problem is that almost every tool you would naturally use to record your app produces a video higher than 30 fps.

  • iPhone screen recording (Control Center) records at up to 60 fps.
  • QuickTime screen recording on Mac records at a variable frame rate, often around 60 fps.
  • Xcode Simulator recording can also produce a variable frame rate video.

So, the default output of every recording tool fails Apple's requirement. You need to convert the video to 30 fps before uploading.

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

Sponsor sarunw.com and reach thousands of iOS developers.

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

To fix the error, you need to re-encode your video with a constant frame rate of 30 fps.

Option 1: ffmpeg

If you are comfortable with the command line, you can convert the video with ffmpeg.

ffmpeg -i input.mov -filter:v fps=30 -c:v libx264 -preset slow -crf 18 -c:a aac -ar 48000 output.mp4

This forces a constant 30 fps and encodes the video in H.264, which is one of the formats App Store Connect accepts.

Keep in mind that ffmpeg only fixes the frame rate here. Your video still needs to pass all the other requirements: an exact resolution like 886×1920, a duration between 15–30 seconds, and an audio track. Each of these has its own error message and its own fix.

Option 2: App Preview Converter (one click)

I ran into this error (and all its friends) so many times that I built a Mac app to fix it: App Preview Converter.

You drop in any screen recording, pick the device you are uploading for, and it exports a video that passes every App Store Connect requirement at once:

  • Constant 30 fps frame rate.
  • The exact resolution for your selected device (886×1920, 1920×886, 1200×1600, and every other slot).
  • Trimmed to the 15–30 second window.
  • A silent audio track added if your recording has none (yes, Apple requires one).
  • H.264 in an accepted container.

No ffmpeg flags to remember, and no more upload-fail-fix-repeat loop with App Store Connect.

The frame rate error is usually just the first one you hit. Once it is fixed, App Store Connect may complain about the next requirement:

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 app preview specifications in App Store Connect Help.

You may also like

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 wrong resolution error in App Store Connect

App Store Connect only accepts app preview videos with exact resolutions like 886×1920. Learn every accepted size and how to convert your recording to match.

Next
How to declare a memberwise initializer in a Swift extension

SE-0546 proposes allowing us to declare a struct's memberwise initializer in a same-file extension. Let's see how it works.

← Home

Sarunw

Support

Elsewhere

Info