What is tus?

tus is an open protocol for resumable file uploads over HTTP. If an upload is interrupted, it continues from where it stopped instead of starting over.

How tus works

A typical tus upload has three steps. The client sends a POST request to create the upload and gets back a URL for it. It then sends the file’s bytes with PATCH requests, each stating the Upload-Offset it starts at. After a dropped connection, the client sends a HEAD request to ask how many bytes the server has, and carries on from that offset. Transloadit started the protocol in 2013 and maintains it as an open project.

Key facts

  1. The current version is tus 1.0.0. Every request except OPTIONS carries the header Tus-Resumable: 1.0.0.
  2. Open source implementations include the tusd server and clients such as tus-js-client, Uppy, and libraries for iOS and Android.
  3. The name is usually written in lowercase, and the specification is published at tus.io.

When tus matters

Use tus when uploads are large or connections are unreliable, such as video from mobile devices. It needs a tus client in your app and a tus server, or a service that speaks the protocol.

How Transloadit helps with tus

Transloadit accepts tus uploads for the files in an Assembly, so large uploads to it resume after an interruption. The Uppy file uploader uses tus for this automatically through its Transloadit plugin.

Explore Transloadit’s platform capabilities

Turn media knowledge into a working pipeline

Connect uploads, processing, AI, storage, and delivery through one declarative API — with the encoding stack, scaling, and format churn handled for you.

Try Transloadit for free