# Properly preserve transparency across image types

[🤖/image/resize](/docs/robots/image-resize.md) allows you to set a custom background for resized images. By default, a white background is added to transparent images. In order to preserve transparency, please use `"background": "none"`. In this demo we use[🤖/file/filter](/docs/robots/file-filter.md) to preserve transparency, only for file types that support it (PNG, GIF, etc.).

Alternatively you could use enable `output_meta.has_transparency` and then check`${file.meta.has_transparency}` for `true`.

Step 1:

### ![Handle uploads](/_next/static/immutable/media/handling-uploads.36rsz9f-z39wy.svg)Handle uploads

We can handle uploads of your users directly.[Learn more ›](/services/handling-uploads.md)

![fender-png-with-trans.png](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)

[fender-png-with-trans.png](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)

Image – 1.1 MB

1241 × 3747

![chameleon.jpg](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

[chameleon.jpg](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

Image – 3.3 MB

4799 × 3199

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

🤖 [/upload/handle](/docs/robots/upload-handle.md)

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

Step 2:

### ![Filter files](/_next/static/immutable/media/file-filtering.0hnpnj2dq3y_q.svg)Filter files

We let you reject, or direct files against different encoding Steps.[Learn more ›](/services/file-filtering.md)

![chameleon.jpg](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

[chameleon.jpg](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

Image – 3.3 MB

4799 × 3199

```
"nontransparent_filtered": {
  "use": ":original",
  "robot": "/file/filter",
  "result": true,
  "accepts": [
    [
      "${file.mime}",
      "regex",
      "image/jpe?g"
    ]
  ],
  "error_on_decline": false
}
```

🤖 [/file/filter](/docs/robots/file-filter.md)

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

Step 3:

### ![Filter files](/_next/static/immutable/media/file-filtering.0hnpnj2dq3y_q.svg)Filter files

We let you reject, or direct files against different encoding Steps.[Learn more ›](/services/file-filtering.md)

![fender-png-with-trans.png](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)

[fender-png-with-trans.png](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)

Image – 1.1 MB

1241 × 3747

```
"maybetransparent_filtered": {
  "use": ":original",
  "robot": "/file/filter",
  "result": true,
  "declines": [
    [
      "${file.mime}",
      "regex",
      "image/jpe?g"
    ]
  ],
  "error_on_decline": false
}
```

🤖 [/file/filter](/docs/robots/file-filter.md)

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

Step 4:

### ![Convert, resize, or watermark images](/_next/static/immutable/media/image-processing.01ifhto-sjz1y.svg)Convert, resize, or watermark images

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.[Learn more ›](/services/image-processing.md)

![chameleon.jpg](https://demos.transloadit.com/9e/e0f4fc5627414191f742d8f42bacb4/chameleon.jpg)

[chameleon.jpg](https://demos.transloadit.com/9e/e0f4fc5627414191f742d8f42bacb4/chameleon.jpg)

Image – 75 KB

400 × 266

```
"nontransparent_resized": {
  "use": "nontransparent_filtered",
  "robot": "/image/resize",
  "result": true,
  "height": 300,
  "resize_strategy": "fit",
  "width": 400
}
```

🤖 [/image/resize](/docs/robots/image-resize.md)

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

Step 5:

### ![Convert, resize, or watermark images](/_next/static/immutable/media/image-processing.01ifhto-sjz1y.svg)Convert, resize, or watermark images

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more.[Learn more ›](/services/image-processing.md)

![fender-png-with-trans.png](https://demos.transloadit.com/13/7654503f3d49eda8710359b0dfc78a/fender-png-with-trans.png)

[fender-png-with-trans.png](https://demos.transloadit.com/13/7654503f3d49eda8710359b0dfc78a/fender-png-with-trans.png)

Image – 12 KB

99 × 300

```
"maybetransparent_resized": {
  "use": "maybetransparent_filtered",
  "robot": "/image/resize",
  "result": true,
  "background": "none",
  "height": 300,
  "resize_strategy": "fit",
  "width": 400
}
```

🤖 [/image/resize](/docs/robots/image-resize.md)

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

Step 6:

### ![Export files to Amazon S3](/_next/static/immutable/media/file-exporting.1zp-mu826z4vh.svg)Export files to Amazon S3

We export to the storage platform of your choice.[Learn more ›](/services/file-exporting.md)

`:original`

* [https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png⁠](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)
* [https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg⁠](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

`nontransparent_filtered`

* [https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg⁠](https://demos.transloadit.com/eb/a9d29d4cd242efac9ea784ebad9a2a/chameleon.jpg)

`maybetransparent_filtered`

* [https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png⁠](https://demos.transloadit.com/91/0412e921e84b0d84a298289be2c505/fender-png-with-trans.png)

`nontransparent_resized`

* [https://demos.transloadit.com/9e/e0f4fc5627414191f742d8f42bacb4/chameleon.jpg⁠](https://demos.transloadit.com/9e/e0f4fc5627414191f742d8f42bacb4/chameleon.jpg)

`maybetransparent_resized`

* [https://demos.transloadit.com/13/7654503f3d49eda8710359b0dfc78a/fender-png-with-trans.png⁠](https://demos.transloadit.com/13/7654503f3d49eda8710359b0dfc78a/fender-png-with-trans.png)

```
"exported": {
  "use": [
    "nontransparent_filtered",
    "maybetransparent_filtered",
    "nontransparent_resized",
    "maybetransparent_resized",
    ":original"
  ],
  "robot": "/s3/store",
  "credentials": "demo_s3_credentials",
  "url_prefix": "https://demos.transloadit.com/"
}
```

🤖 [/s3/store](/docs/robots/s3-store.md)

This bot exports encoding results to Amazon S3

## Live Demo. See for yourself

Loading Uppy demo…

This live demo is powered by [Uppy⁠](https://uppy.io), our open source file uploader that you can also use without Transloadit, and [tus⁠](https://tus.io), 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',
            },
            nontransparent_filtered: {
              use: ':original',
              robot: '/file/filter',
              result: true,
              accepts: [['${file.mime}', 'regex', 'image/jpe?g']],
              error_on_decline: false,
            },
            maybetransparent_filtered: {
              use: ':original',
              robot: '/file/filter',
              result: true,
              declines: [['${file.mime}', 'regex', 'image/jpe?g']],
              error_on_decline: false,
            },
            nontransparent_resized: {
              use: 'nontransparent_filtered',
              robot: '/image/resize',
              result: true,
              height: 300,
              resize_strategy: 'fit',
              width: 400,
            },
            maybetransparent_resized: {
              use: 'maybetransparent_filtered',
              robot: '/image/resize',
              result: true,
              background: 'none',
              height: 300,
              resize_strategy: 'fit',
              width: 400,
            },
            exported: {
              use: [
                'nontransparent_filtered', 
,                'maybetransparent_filtered', 
,                'nontransparent_resized', 
,                'maybetransparent_resized', 
,                ':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](/docs/sdks/uppy.md)

## 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](/services/file-importing.md) to acquire and transcode massive media libraries.

#### Handling uploads

We are *the* experts at reliably [handling uploads](/services/handling-uploads.md). We wrote the [protocol⁠](https://tus.io/) for it.

#### Front-end integration

We integrate with web browsers via our next-gen file uploader [Uppy⁠](https://uppy.io/) and SDKs for Android and iOS.

#### Back-end integration

Send us batch jobs in any server language using one of our [SDKs](/docs/sdks.md) or directly interfacing with our [REST API](/docs/api.md).

#### Pingbacks

Configure a [notify\_url](/services/content-delivery.md) to let your server receive transcoding results JSON in the `transloadit` POST field.

#### On-demand

Use our [Smart CDN](/services/file-importing.md) to adapt files on-demand and stream them directly to your users.

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

## Other cool demos

[![Image processing](/assets/images/services/image-processing.svg?dpl=dpl_2va3YBn22HhLsqATrmvGRCEgnYNE)Image processingAdd a sepia effect to an image](/demos/image-processing/add-sepia-effect-to-an-image.md)[![Image processing](/assets/images/services/image-processing.svg?dpl=dpl_2va3YBn22HhLsqATrmvGRCEgnYNE)Image processingApply a text watermark to images](/demos/image-processing/text-watermarking.md)[![Document processing](/assets/images/services/document-processing.svg?dpl=dpl_2va3YBn22HhLsqATrmvGRCEgnYNE)Document processingAdd a header of footer to a PDF](/demos/document-processing/add-header-or-footer-to-pdf.md)

Try Transloadit

## Ready to get started?

Join thousands of developers who trust Transloadit for their file processing needs.

Building file processing from scratch

Ready-to-use API & SDKs

Scaling infrastructure headaches

Auto-scaling global infrastructure

Managing codec updates

Always up-to-date processing

Handling file security

Enterprise-grade security

Supporting all file formats

1000+ formats & codecs supported

Unpredictable costs

Transparent pricing

GDPR

GDPR

HIPAA

HIPAA

ISO 27001ISO27001

ISO 27001

AES-256

AES-256

SOC 2 Type II

SOC 2 Type II

[Try Transloadit for Free](/c/signup/)

[Try Transloadit for Free](/c/signup/)

No credit card needed · 5 GB included in the free plan · Cancel anytime
