Transloadit
Pricing
  • File Uploads
  • File Importing
  • Batch Processing
  • Video Encoding
  • Audio Encoding
  • Image Processing
  • Document Processing
  • Artificial Intelligence
  • File Filtering & Security
  • Media Cataloging
  • File Compression
  • Code Evaluation
  • File Exporting
  • Smart CDN
  • View all services
  • Explore integrations
  • Explore live demos
  • Uppy
  • TransloaditKit
  • Android SDK
  • Node.js SDK
  • Python SDK
  • Ruby SDK
  • Go SDK
  • Java SDK
  • PHP SDK
  • Zapier
  • MCP Server
  • Transloadit CLI
  • Terraform
  • Essentials
  • Best Practices
  • FAQ
  • Robots
  • API
  • Formats
  • Build your first app
  • About
  • Comparisons
  • Open Source
  • Testimonials
  • Jobs
  • Security
  • Posts
  • DevTimes
  • DevTips
  • Press
  • Research
  • Case Studies
  • Solutions
  • Guides
  • Glossary
  • Legal
  • Tools
  • Helping Coursera bring education to millions around the world
  • Transloadit Support
  • Open Source Support
  • Service level agreement
EssentialsRobotsFAQAPIFormatsBest Practices

How to rename files when exporting them to cloud storage?

Set the /s3/store Robot’s path parameter to choose the exported object key. This changes the destination name, not the input file or its metadata. Other export Robots have their own path rules; check the destination Robot’s documentation.

This Template adds renamed- to the file’s URL-safe name and places it under a unique prefix. It uses the private-bucket configuration from the S3 setup guide:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/s3/store",
      "use": ":original",
      "credentials": "YOUR_S3_CREDENTIALS",
      "acl": "bucket-default",
      "path": "uploads/${unique_prefix}/renamed-${file.url_name}"
    }
  }
}

Replace YOUR_S3_CREDENTIALS with a saved Template Credential whose permissions cover the destination prefix. acl: "bucket-default" omits the object ACL; bucket and IAM policies still control access. See protecting credentials and instructions before exposing this flow to a browser.

Variables such as ${file.url_name} are resolved during processing. A path using file metadata or a unique prefix is not a complete object key that your application can necessarily know before upload. Read the completed Assembly’s export result rather than inferring a public download URL.

See also:

How does Transloadit store Assemblies?
What’s the maximum file size?
Why did an Assembly Step produce no results?
Contact support⁠

TransloaditChecking status…

Product

  • Services
  • Pricing
  • Demos
  • Tools
  • Security
  • Support

Company

  • About/Press
  • Blog/Jobs
  • Comparisons/Compliance matrix
  • Research
  • Open source
  • Solutions
  • Pioneers of the web

Docs

  • Getting started
  • Transcoding
  • FAQ
  • API
  • Guides/DevTips
  • Supported formats

More

  • Platform status⁠
  • Community forum⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®, tus®, and Uppy® are registered trademarks of Transloadit-II GmbH in the United States.

PrivacyTermsImprintTrademarksDMCA Policy
EnglishDeutschEspañolFrançaisPortuguês (Brasil)