We are a Swiss Army knife for your files
Transloadit is a service for companies with developers. We handle their file uploads and media processing. This means that they can save on development time and the heavy machinery that is required to handle big volumes in an automated way.
We pioneered with this concept in 2009 and have made our customers happy ever since. We are still actively improving our service in 2026, as well as our open source projects uppy.io and tus.io, which are changing how the world does file uploading.
Filter out portrait-oriented images
In this demo, we import two image files, one landscape the other portrait. Then using 🤖/file/filter, reject the uploaded portrait-oriented image.
Using the accept parameter, we are able to choose certain meta data conditions for the
Robot to accept. First we, select that only image files can be passed, then using the
images embedded meta data, we select any aspect ratio greater than 1 can be accepted.
:bulb: The set aspect ratio value is based around width/height and, as such, the value 1 would be square, making anything greater than 1 landscape-oriented. For example, if you wanted a 4/3 image, you would choose 1.33 or if you wanted a 16/9 image, you would choose 1.77
Following these conditions, we use 🤖/s3/export to send the filtered file to a S3 storage bucket.
To see other meta data conditions 🤖/file/filter can follow, please see our Available Job Variables page.
Step 1:
Handle uploads
We can handle uploads of your users directly.Learn more


":original": {
"robot": "/upload/handle"
}Step 2:
Filter files
We let you reject, or direct files against different encoding Steps.Learn more

"files_filtered": {
"use": ":original",
"robot": "/file/filter",
"result": true,
"accepts": [
[
"${file.meta.aspect_ratio}",
">",
"1.0"
],
[
"${file.mime}",
"regex",
"image"
]
],
"condition_type": "and"
}Step 3:
Export files to Amazon S3
We export to the storage platform of your choice.Learn more
"exported": {
"use": [
"files_filtered",
":original"
],
"robot": "/s3/store",
"credentials": "demo_s3_credentials",
"url_prefix": "https://demos.transloadit.com/"
}Live Demo. See for yourself
Loading Uppy demo…
This live demo is powered by
Uppy, our open source file uploader that you can also use without Transloadit, and
tus, our open protocol for resumable file uploads that is making uploading more reliable across the world.
Build this in your own language
<!-- This pulls Uppy from our CDN -->
<!-- For smaller self-hosted bundles, install Uppy and plugins manually: -->
<!-- npm i --save @uppy/core @uppy/dashboard @uppy/remote-sources @uppy/transloadit ... -->
<link
href="https://releases.transloadit.com/uppy/v3.10.0/uppy.min.css"
rel="stylesheet"
/>
<button id="browse">Select Files</button>
<script type="module">
import {
Uppy,
Dashboard,
ImageEditor,
RemoteSources,
Transloadit,
} from 'https://releases.transloadit.com/uppy/v3.10.0/uppy.min.mjs'
const uppy = new Uppy()
.use(Transloadit, {
waitForEncoding: true,
alwaysRunAssembly: true,
assemblyOptions: {
params: {
// It's often better store encoding instructions in your account
// and use a `template_id` instead of adding these steps inline
steps: {
':original': {
robot: '/upload/handle',
},
files_filtered: {
use: ':original',
robot: '/file/filter',
result: true,
accepts: [['${file.meta.aspect_ratio}', '>', '1.0'], ['${file.mime}', 'regex', 'image']],
condition_type: 'and',
},
exported: {
use: ['files_filtered', ':original'],
robot: '/s3/store',
credentials: 'demo_s3_credentials',
url_prefix: 'https://demos.transloadit.com/',
},
},
},
},
})
.use(Dashboard, { trigger: '#browse' })
.use(ImageEditor, { target: Dashboard })
.use(RemoteSources, {
companionUrl: 'https://api2.transloadit.com/companion',
})
.on('complete', ({ transloadit }) => {
// Due to `waitForEncoding:true` this is fired after encoding is done.
// Alternatively, set `waitForEncoding` to `false` and provide a `notify_url`
console.log(transloadit) // Array of Assembly Statuses
for (const assembly of transloadit) {
console.log(assembly.results) // Array of all encoding results
}
})
.on('error', (error) => {
console.error(error)
})
</script>
So many ways to integrate
Transloadit is a service for companies with developers. And there are many ways developers can put Transloadit to good use inside your company to automate media processing.
Bulk imports
Add one of our import Robots to acquire and transcode massive media libraries.
Handling uploads
We are the experts at reliably handling uploads. We wrote the protocol for it.
Front-end integration
We integrate with web browsers via our next-gen file uploader Uppy and SDKs for Android and iOS.
Back-end integration
Send us batch jobs in any server language using one of our SDKs or directly interfacing with our REST API.
Pingbacks
Configure a notify_url to let your server receive transcoding results JSON in the transloadit POST field.
On-demand
Use our Smart CDN to adapt files on-demand and stream them directly to your users.
