X Video Stuck Processing? MOV Is the Format X Names

Sep 21, 2026

X's own documentation names .mov as the file type that gets stuck in processing most often — and tells you to re-export as .mp4. That is unusually direct for a platform help page, and it means you do not have to guess at this one.

The catch is that the advice lives on a page with a narrow scope, and the wait is longer than most people are willing to sit through. Both details change what you should do.

What "stuck processing" actually means

Uploading and processing are two separate stages. The transfer can finish while the spinner keeps going, because X is still ingesting the file on its side. Its Media Studio help page puts a number on how long that stage is allowed to take:

"Processing: Stuck at 5% — It could take up to 30 minutes for your media file to complete processing. If the system cannot process the file within that timeframe, the upload will fail and the 'Upload failed' error message will appear."

Two things follow. First, a bar that has not moved in ten minutes is not necessarily dead — the documented window is up to 30 minutes. Second, the failure mode is not a silent hang: when the window runs out, you get the "Upload failed" message rather than an infinite spinner.

On the developer side, X describes the same stage as a state machine — "Processing states: pendingin_progresssucceeded or failed" — which is a useful mental model even if you are uploading through the web interface: there is a terminal state coming, one way or the other.

Scope matters here. The 30-minute text is on the Media Studio Library page, and that page declares its own boundaries: "These instructions are only valid for Media Studio, and should not be followed for usage of the X developer API, Pro Media API, desktop upload, or mobile upload." Media Studio is also not open to everyone — X states that "Access to Media Studio will be given to verified subscribers only." So treat the 30 minutes as documented for Media Studio; X does not publish an equivalent number for ordinary web or mobile uploads.

Why MOV specifically

Immediately after the passage above, the same page singles out one format:

"This happens most often with .mov files. If possible, re-export files as .mp4, which should allow for overall faster upload and processing time."

Read what that sentence does and does not say. It does not say MOV is unsupported. Media Studio's own file-type line is "Type: .MP4, .MOV", and on the API side video/quicktime sits in the accepted media_type list alongside video/mp4. MOV is accepted. It is simply the format X points at when processing drags.

X does not explain why in the pages it publishes, so neither will this article. There is also nothing official about how X handles ProRes, alpha channels, or 10-bit footage — those come up constantly in forum threads and X's documentation does not state it.

The fastest fix: hand X an MP4 instead

Since the official guidance is "re-export files as .mp4", the shortest path is to convert the file before X ever sees it. That removes the variable X named, and it costs a couple of minutes against a processing window that can otherwise run half an hour before failing.

Try it right here

Runs in your browser. Your file is not uploaded anywhere.

Loading tool…

This runs inside your browser tab. The file is read from disk, re-encoded locally, and handed back — it is never uploaded to a server, so there is no second upload to sit through while fixing the first. The same tool has its own page at MOV to MP4 if you would rather bookmark it.

If you are aiming at Media Studio's encoding guidance while you are at it, those values are published: "Video specification: AVC encoding (H264)", "Recommended video bitrate: 5-8 mbps", "Maximum video framerate: 60 FPS", and "Audio specification: stereo/mono AAC (LC)".

Other causes, in order of likelihood

You cannot even select the .mov in the file picker. X documents a workaround for this exact case: "If you are unable to select an .mov file via the file selection window, attempt to upload the file by dragging it into your Media Studio Library." Drag and drop instead of browsing.

The file is too big, or the bitrate is too high. X's "Upload failed" entry lists the causes together: "This error can appear for a few different issues: file size, resolution, encoding settings, or a connection issue. First ensure that your video file is 8GB or smaller in size—reducing the video bitrate of the file is the easiest solution for making a smaller file size." The 8GB figure is Media Studio's stated maximum; other X surfaces publish different numbers, so check the official documentation for the one that applies to how you upload. If your file needs to come down, compress video does the bitrate reduction X recommends.

Your file is under the cap and still fails. X says so itself on the Ads side: "Even if your file is under our maximum size, we may still have issues ingesting the file. Reducing the size of the file reduces the time of the upload, maximizing your chances for success." Being under the limit is not a guarantee.

An encoding constraint you cannot see in the file's properties. X's developer documentation lists requirements that have nothing to do with size: pixel aspect ratio "must have 1:1"; "Only YUV 4:2:0 is supported"; audio "must be AAC with Low Complexity profile" and "(High-Efficiency AAC is not supported)"; audio "must be mono or stereo, not 5.1 or greater"; the file "Must not have open GOP" and "Must use progressive scan". These are stated for the API. X does not say which error message any of them produces.

The error text is lying to you. One entry is worth memorising: "Error: 'Video too long' — This error usually appears when uploading media that isn't in a supported format." If you get told your video is too long and you know it is not, stop trimming and look at the format.

The network dropped mid-upload. From the same "Upload failed" passage: "if there is any packet loss or connection failure at the time of upload, the entire process will fail and need to be restarted." X's advice for Ads uploads is blunt about it: "Try uploading your video on a different wifi network. The faster the wifi speed, the greater chance the video will upload."

How to tell it worked

Watch for a terminal state rather than a moving bar. If processing completes, you are through the stage the 30-minute window governs. If it fails, you should see "Upload failed" rather than an endless spinner — and at that point you have a named cause list to work through rather than a mystery.

One more thing to know if you post through the API: X says "Upload limits and Post-create limits are separately enforced" and that "A media_id that finalized successfully can still be rejected by POST /2/tweets". A clean upload is not the same as a published post.

FAQ

How long should I wait before assuming an X upload is stuck? X's Media Studio page says "It could take up to 30 minutes for your media file to complete processing." If the system cannot finish inside that window, the upload fails and shows "Upload failed" — so waiting out the full window costs you nothing but time.

Does X support MOV files? Yes, in the places where X publishes a file-type list. Media Studio's is "Type: .MP4, .MOV", and the API accepts video/quicktime. X has never published a complete format list for ordinary web or mobile uploads — check the official documentation.

Should I convert MOV to MP4 before uploading to X? X's own wording is "If possible, re-export files as .mp4, which should allow for overall faster upload and processing time." That is the platform's advice, not an outside opinion.

Why does X say my video is too long when it is not? X documents this directly: "This error usually appears when uploading media that isn't in a supported format." Treat "Video too long" as a possible format complaint.

My file is well under the size cap and still will not upload. Now what? Re-encode it anyway. X states that files under the maximum can still fail to ingest, and recommends reducing size and bitrate to improve the odds. Start with a clean H.264 MP4 — see all Clapr tools for the converters and compressors that do it in-browser.


Quotations are from X's help centre and developer documentation as recorded on 16 September 2026. X publishes different numbers on different pages for several of these limits — verify against the official page for the surface you are actually uploading through. More troubleshooting walkthroughs are in the fix guides, and a related case is covered in MOV to MP4 for Instagram Reels.

Clapr team

Clapr team

X Video Stuck Processing? MOV Is the Format X Names | Clapr Blog