Uploadcare Intro

Uploadcare handles uploading, storing and processing files for you. All components of Uploadcare, from widget to CDN, work seamlessly together, require almost no configuration and allow maximum flexibility exactly when you need it.

We will not dive into the details regarding server-side framework and stack in this intro. However, after reading it you should understand how our libraries work, and using any particular one of them will be easy.

Getting started

How does Uploadcare work?

Uploadcare consists of three components: Upload, Storage and CDN. Upload interfaces, such as the browser widget and components for mobile applications, allow users to upload files. Whenever a file is uploaded, your application receives a CDN link with file UUID, which can be used by the REST API to get detailed information about the file, store or copy it. Any file you’ve stored is available via CDN, which delivers original files to your users, as well as versions of them tailored for your needs: thumbnails and whatnot.


In order to use Uploadcare, you will need to sign up. Registration is free (no credit card required) and very easy: in fact, you can sign up with your Google or GitHub account, so you don't have to think up a new password. After successfully completing your registration, you will receive public and private keys for your project that allow you to interact with our service.


The first step is to provide users the ability to upload files. If you plan to use our service for the Web, all you need to do is integrate our widget on your site. If you are more of a mobile guy you can integrate Uploadcare library to your mobile application. Of course, you can also do both.


Our website widget is provided as a typical Javascript library, which can be easily embedded in your site. The widget is highly customizable for your needs. It supports uploading many files at once, manual crop, social networks and cloud storage integrations and many other features. In addition, we provide rich Javascript API for complex forms and web applications.


Once a file is uploaded, your application receives CDN link with file UUID. This UUID is unique for each file.

An uploaded file is available via our CDN for 24 hours and is deleted afterwards. During this period you can:

  • store it in Uploadcare storage to benefit from our CDN and on the fly image processing.
  • copy the original file or its processed version to your s3 bucket using our API.
  • download the original file or its processed version from CDN and do whatever you wish with it.

Learn more about storages.


Stored and newly uploaded files are available via the http://www.ucarecdn.com server. For example, you can easily display a picture if you know its uuid:

<img src="http://www.ucarecdn.com/5651bbb6-c599-44bd-9c63-1db5e67db6ad/" />

A file download link looks the same:

<a href="http://www.ucarecdn.com/5651bbb6-c599-44bd-9c63-1db5e67db6ad/">
    Download file!

Image Processing

In addition to simple file hosting, our CDN processes images before displaying them with our simple DSL for image processing. To change image processing parameters, just edit URL of the file. It's incredibly easy to use and saves you from handling different sizes of pictures.

CDN supports multiple operations such as crop, resize, scale_crop and effect. You can use multiple operations one by one, specifying parameters in the URL like this:



Likewise, you can append any filename to the link:


The full description of CDN features can be found here.

Try it yourself!

The Quick Start will guide you through the integration process.

We try very hard to make Uploadcare as convenient and simple as possible. To find out about other Uploadcare features, see other links on the left side of the page.

We are always happy to hear from our users or anyone considering becoming one. Contact Us if you have any questions, comments or suggestions.

Thank you!
Uploadcare Team

If you haven't found what you were looking for in these docs, try looking in our Knowledge Base.