[Fix] Twitter Video Upload Error “Your media file could not be processed”

When you try to upload a video on Twitter, error “Your media file could not be processed” may be displayed during the processing stage. Twitter lists out the specifications for media files on their support site. If your media file doesn’t fit into their technical specifications, the error appears.

twitter media file not processed error

This post tells you how to resolve the problem.

What type of videos does Twitter support?

According to Twitter, your video file needs to match the following specs:

  • Minimum resolution: 32 x 32
  • Maximum resolution: 1920 x 1200 (and 1200 x 1900)
  • Aspect ratios: 1:2.39 – 2.39:1 range (inclusive)
  • Maximum frame rate: 40 fps
  • Maximum bitrate: 25 Mbps

Twitter currently supports MP4 and MOV video formats on mobile apps. On the web, Twitter supports the MP4 video format with H264 format with AAC audio. Videos up to 512MB can be uploaded. However, you will be prompted to edit videos to 2 minutes and 20 seconds or less in length.

How to Fix “Your media file could not be processed.” on Twitter?

Handbrake is a 3rd party application that converts video from nearly any format to a selection of modern, widely supported codecs. Using Handbrake you can turn or encode any video so that it becomes compliant with Twitter’s specifications.

  1. Download Handbrake and run it.
  2. Open the video file in Handbrake.
    twitter media file not processed fix using handbrake
  3. In the Save As: field, mention the path and filename for the file you’re going to modify. Leave the default settings and Presets as they are.
  4. Click Start Encode. The encoded file is now saved to the chosen location. See if you can upload it on Twitter.

You should have noticed an option (checkbox) named Web Optimized in Handbrake user interface. Web Optimized option for the MP4 container, if enabled, moves some of the video metadata from the end to the beginning of the final video file. As Handbrake documentation describes, this option is mostly useful for streaming on the internet. As far as the Twitter error is concerned, enabling Web Optimized setting is optional.

Handbrake Command-line interface (CLI) tool

Handbrake also has a command-line version of the tool if you need to bulk encode media files with the Windows batch file or script. Download HandBrakeCLI and extract the contents to a folder.

Use the following syntax to encode a file:

handbrakecli.exe -i "source_file_name" -o "target_file_name"

Twitter Video Upload Error Your media file could not be processed

The above command will encode with default “Normal” Preset. If you want to encode with with customized bitrate, framerate, and other settings, etc., refer to the (Official) HandBrake Documentation — CLI Options.

That’s it! You should be able to upload the encoded version of the video on Twitter without getting the error “Your media file could not be processed.”

One small request: If you liked this post, please share this?

One "tiny" share from you would seriously help a lot with the growth of this blog. Some great suggestions:
  • Pin it!
  • Share it to your favorite blog + Facebook, Reddit
  • Tweet it!
So thank you so much for your support, my reader. It won't take more than 10 seconds of your time. The share buttons are right below. :)

About the author

Ramesh Srinivasan founded Winhelponline.com back in 2005. He is passionate about Microsoft technologies and he has been a Microsoft Most Valuable Professional (MVP) for 10 consecutive years from 2003 to 2012.

7 thoughts on “[Fix] Twitter Video Upload Error “Your media file could not be processed””

  1. Hello,

    thanks for sharing.

    Can I ask you a question?

    After I download this app and upload video, click “Strat Encode” and it will shown: “The output directory you have chosen eiter does not exist, or you do not have permissions to write files to it.”

    What’s the reason for that?

    Thanks for your help

    • @scarlett: Which directory you’re using for output? Can you set Desktop as the output directory to see if that works?

      If you’re using Windows Defender, see if adding handbrake’s executable to the CFA whitelist helps.

  2. After following the steps, when I go through Twitter and try to upload the post, Twitter does not seem to recognize the Handbrake encoded file – any tips?

  3. There are presets for handbrake. You can encode for a huge variety from 4k-video very low-quality.
    It would be helpful to include the settings necessary to upload it on twitter.


Leave a Comment