DocumentationUploading › Resumable uploads

Resumable uploads

How VideoPlayer.ai recovers from dropped connections during upload.

Last updated: 2026-05-02

Uploading a multi-gigabyte video over flaky wifi used to mean starting over every time the connection dropped. VideoPlayer.ai uses the tus resumable upload protocol so that does not happen. If your connection drops, the upload picks up from the last completed chunk when you come back.

How it works

The browser breaks the file into chunks (typically a few megabytes each) and sends them one at a time over HTTPS. The server acknowledges each chunk. The client tracks which chunks succeeded. If the network fails mid-upload, the client retries the failed chunk on the next attempt; previously sent chunks are not resent.

The chunk state lives on the server for 24 hours. If you come back within that window, the upload resumes. Past 24 hours, the partial upload is cleaned up and you start over.

What you can do

  • Pause the upload and come back later.
  • Close the browser tab. Open it again, return to the upload, and continue.
  • Switch from wifi to a tethered connection mid-upload.
  • Upload from a flaky cafe network without losing progress on every drop.

What you cannot do

  • Resume across different devices. The chunk identifier is tied to the browser session that started the upload.
  • Resume past 24 hours. After that the partial is garbage-collected.
  • Resume an upload that was canceled. Cancel deletes the partial state immediately.

Trouble?

If an upload is stuck, see Upload fails for the most common causes and fixes.

Related