Transloadit
Pricing
EssentialsRobotsFAQAPIFormatsBest Practices

How to rename files when exporting them to cloud storage?

When exporting files from Transloadit to a third party service, you might also want to change the name of the file so it is easily found later.

For example, when exporting to one of our supported exporting services like S3, you can specify the file name as part of the path parameter.

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "use": ":original",
      "robot": "/s3/store",
      "credentials": "S3_CREDENTIALS",
      "path": "renameFiles/${file.id}-${file.original_name}"
    }
  }
}

When importing your files from a URL, Transloadit will automatically derive the name of the file from the URL. Although, if you'd rather specify your own name for the file, that's also possible with the force_name parameter.

{
  "steps": {
    "imported": {
      "robot": "/http/import",
      "url": "http://demos.transloadit.com/inputs/empty-sound.mp3",
      "force_name": "audio",
      "result": true
    }
  }
}

The code above will rename the imported file to audio.mp3.

See also:

What if my imports or exports from Backblaze, S3, GCP, etc. are slow?
How to upload files of any type and then process them based on their filetype?
Do Templates have mandatory parameters?
Transloadit
© 2009–2026 Transloadit-II GmbH
Privacy⋅Terms⋅Imprint

Product

  • Services
  • Pricing
  • Demos
  • Security
  • Support

Company

  • About / Press
  • Blog / Jobs
  • Comparisons
  • Open source
  • Solutions

Docs

  • Getting started
  • Transcoding
  • FAQ
  • API
  • Supported formats

More

  • Platform status
  • Community forum
  • StackOverflow
  • Uppy
  • Tus