Merge images into a grid layout

Step 1:

Handle uploadsHandle uploads

We can handle uploads of your users directly.Learn more

streetsign1.jpg
streetsign1.jpg

Image – 23 KB

400 × 400

streetsign2.jpg
streetsign2.jpg

Image – 110 KB

1000 × 1000

flower1.jpg
flower1.jpg

Image – 608 KB

1980 × 1311

flower2.jpg
flower2.jpg

Image – 2.7 MB

4752 × 3168

":original": {
  "robot": "/upload/handle"
}

/upload/handle

This bot receives uploads that your users throw at you from browser or apps, or that you throw at us programmatically

Step 2:

Convert, resize, or watermark imagesConvert, resize, or watermark images

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.Learn more

flower1.jpg
flower1.jpg

Image – 4.5 KB

100 × 100

streetsign1.jpg
streetsign1.jpg

Image – 3.7 KB

100 × 100

streetsign2.jpg
streetsign2.jpg

Image – 3.5 KB

100 × 100

flower2.jpg
flower2.jpg

Image – 6.3 KB

100 × 100

"resize": {
  "use": ":original",
  "robot": "/image/resize",
  "result": true,
  "height": 100,
  "resize_strategy": "fillcrop",
  "width": 100
}

/image/resize

This bot resizes, crops, changes colorization, rotation, and applies text and watermarks to images

Step 3:

Filter filesFilter files

We let you reject, or direct files against different encoding Steps.Learn more

flower1.jpg
flower1.jpg

Image – 4.5 KB

100 × 100

flower2.jpg
flower2.jpg

Image – 6.3 KB

100 × 100

"filter_flower": {
  "use": "resize",
  "robot": "/file/filter",
  "result": true,
  "accepts": [
    [
      "${file.basename}",
      "includes",
      "flower"
    ]
  ]
}

/file/filter

This bot directs files to different encoding Steps based on your conditions

Step 4:

Filter filesFilter files

We let you reject, or direct files against different encoding Steps.Learn more

streetsign1.jpg
streetsign1.jpg

Image – 3.7 KB

100 × 100

streetsign2.jpg
streetsign2.jpg

Image – 3.5 KB

100 × 100

"filter_streetsign": {
  "use": "resize",
  "robot": "/file/filter",
  "result": true,
  "accepts": [
    [
      "${file.basename}",
      "includes",
      "streetsign"
    ]
  ]
}

/file/filter

This bot directs files to different encoding Steps based on your conditions

Step 5:

Merge several images into one imageMerge several images into one image

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.Learn more

flower1.png
flower1.png

Image – 14 KB

100 × 205

"flower_vertical": {
  "use": {
    "steps": [
      "filter_flower"
    ],
    "bundle_steps": true
  },
  "robot": "/image/merge",
  "result": true,
  "background": "#000000",
  "border": 5,
  "direction": "vertical",
  "format": "png"
}

/image/merge

This bot merges several images into a single spritesheet

Step 6:

Merge several images into one imageMerge several images into one image

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.Learn more

streetsign1.png
streetsign1.png

Image – 14 KB

100 × 205

"streetsign_vertical": {
  "use": {
    "steps": [
      "filter_streetsign"
    ],
    "bundle_steps": true
  },
  "robot": "/image/merge",
  "result": true,
  "background": "#000000",
  "border": 5,
  "direction": "vertical",
  "format": "png"
}

/image/merge

This bot merges several images into a single spritesheet

Step 7:

Merge several images into one imageMerge several images into one image

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.Learn more

flower1.png
flower1.png

Image – 24 KB

205 × 205

"merge_horizontal": {
  "use": {
    "steps": [
      "streetsign_vertical",
      "flower_vertical"
    ],
    "bundle_steps": true
  },
  "robot": "/image/merge",
  "result": true,
  "background": "#000000",
  "border": 5,
  "direction": "horizontal",
  "format": "png"
}

/image/merge

This bot merges several images into a single spritesheet

Step 8:

Export files to Amazon S3Export files to Amazon S3

We export to the storage platform of your choice.Learn more

"exported": {
  "use": [
    "resize",
    "filter_flower",
    "filter_streetsign",
    "flower_vertical",
    "streetsign_vertical",
    "merge_horizontal",
    ":original"
  ],
  "robot": "/s3/store",
  "credentials": "demo_s3_credentials",
  "url_prefix": "https://demos.transloadit.com/"
}

/s3/store

This bot exports encoding results to Amazon S3

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',
            },
            resize: {
              use: ':original',
              robot: '/image/resize',
              result: true,
              height: 100,
              resize_strategy: 'fillcrop',
              width: 100,
            },
            filter_flower: {
              use: 'resize',
              robot: '/file/filter',
              result: true,
              accepts: [['${file.basename}', 'includes', 'flower']],
            },
            filter_streetsign: {
              use: 'resize',
              robot: '/file/filter',
              result: true,
              accepts: [['${file.basename}', 'includes', 'streetsign']],
            },
            flower_vertical: {
              use: {
                steps: ['filter_flower'],
                bundle_steps: true,
              },
              robot: '/image/merge',
              result: true,
              background: '#000000',
              border: 5,
              direction: 'vertical',
              format: 'png',
            },
            streetsign_vertical: {
              use: {
                steps: ['filter_streetsign'],
                bundle_steps: true,
              },
              robot: '/image/merge',
              result: true,
              background: '#000000',
              border: 5,
              direction: 'vertical',
              format: 'png',
            },
            merge_horizontal: {
              use: {
                steps: ['streetsign_vertical', 'flower_vertical'],
                bundle_steps: true,
              },
              robot: '/image/merge',
              result: true,
              background: '#000000',
              border: 5,
              direction: 'horizontal',
              format: 'png',
            },
            exported: {
              use: [
                'resize', 
,                'filter_flower', 
,                'filter_streetsign', 
,                'flower_vertical', 
,                'streetsign_vertical', 
,                'merge_horizontal', 
,                ':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>

Read docs: Browsers

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.

Other cool demos

Try Transloadit

Ready to get started?

Join thousands of developers who trust Transloadit for their file processing needs.
Pain Point Icon
Building file processing from scratch
Badge Check Icon
Ready-to-use API & SDKs
Pain Point Icon
Scaling infrastructure headaches
Badge Check Icon
Auto-scaling global infrastructure
Pain Point Icon
Managing codec updates
Badge Check Icon
Always up-to-date processing
Pain Point Icon
Handling file security
Badge Check Icon
Enterprise-grade security
Pain Point Icon
Supporting all file formats
Badge Check Icon
1000+ formats & codecs supported
Pain Point Icon
Unpredictable costs
Badge Check Icon
Transparent pricing
GDPR Icon
HIPAA Icon
ISO 27001ISO27001
AES-256 Icon
AICPA / SOC icon
No credit card needed · 5 GB included in the free plan