How Uploadcare works

Uploadcare is a complete ecosystem of products that optimize your content, conversions, load times, traffic, and UX. All that through handling files.

The four major components of Uploadcare are upload interface, storage, media processing, and CDN. When integrating Uploadcare, you get all of the components seamlessly working together,


There are many ways your files can get to Uploadcare. There is a dialog called Uploadcare Widget, REST and JavaScript APIs, libraries, integrations, and mobile components. All of those together are our “upload interface.” We allow uploading multiple files at once, getting files from social media, edit images in browsers, and more.

You don’t even have to sign up to check out how uploads work. There are things like Quick Start and lots of fun with our demo account keys.

Each time a file gets uploaded, your app receives a CDN link with its unique file identifier, UUID. UUIDs are then used by our APIs to handle files: copy, store, request detailed info: that kind of stuff.


Alright, after uploading you get a CDN link with file UUID. Two things happen to make this real. First, your file is uploaded to our storage. Second, it gets cached on our CDN. Long story short, when you address a file using its UUID, that file is delivered by CDN. Regarding storage, there are two workflows,

CDN delivery

Uploadcare uses Akamai as the default content delivery solution. It allows us to get your media to more than 200,000 servers in over 130 countries. Here is how the CDN link looks like,[:operations/][:filename]

Where identifies you are addressing our CDN, :UUID points at a specific file, :operations tell us what to do with it, and :filename can be set to any RFC3986 compliant string. The last two are optional: your file might be better off with its original filename and no manipulations.

Here’s how you can easily show an image using its :UUID, no "operations or :filename are used in the case,

<img src="" />

And that’s how you let users download the file,

<a href="">

Media processing

Uploadcare allows you to process media files by using our DSL. They also call it “URL directives.” You can use those to process images, GIFs, videos, and detect objects.

For instance, with images, you can do stuff like crop, resize, scale_crop, blur, and more. You can pipe operations, too,

Time to practice

To practice, you might first want to sign up. After the signup, you begin with our Free plan. It’s there forever and is packed with features ready to play with.

Like, you want to try our Quick Start and interactive widget configurator to get how the Uploadcare workflow feels like. If you want to use Uploadcare with a specific language or platform, check out libraries and integrations.

We’re striving to make Uploadcare as useful and simple as possible. Make sure not to miss other links in our sidebar. There’s so much more.

We’re always happy to hear from our users and other awesome folks. Check out our community area or hit us up at

Uploadcare Team

We’re always happy to help with code, integration, and other stuff. Search our site for more info or post your question in our Community Area.