Flag of Ukraine

Renaming files

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.

Uppy
20% off any plan for the Uppy community
Use the UPPY20 code when upgrading.
Sign up
tus
20% off any plan for the tus community
Use the TUS20 code when upgrading.
Sign up
Product Hunt
20% off any plan for Product Hunters
Use the PRH20 code when upgrading.
Sign up