Install File Uploader

  • This is for the version 3.x of the widget. If you're looking for the widget v2 docs, check here
  • Here’s how you migrate from v2 to v3.

If you’re up to manually installing Uploadcare Widget, you’re free to choose one from the install methods listed below,

Please refer to our libraries and integrations for some ready-made solutions.

Before proceeding with your install, check out the requirements and existing types of widget bundles.


External Dependencies and jQuery

Uploadcare Widget does not have any external dependencies except for jQuery. We provide two different versions of our widget: with built-in jQuery and without it. See the types of existing widget bundles for more info.

For instance, with the jQuery-enabled widget version you could go like,

var $ = uploadcare.jQuery;
$('body').append('It works!');

Types of Bundles

There are a few types of js bundles:

  • uploadcare.full.js — a full bundle with built-in jQuery,
  • uploadcare.js — a bundle without built-in jQuery,
  • uploadcare.api.js — a bundle without UI of the widget and built-in jQuery, JavaScript API only,
  • uploadcare.ie8.js — a full bundle with built-in jQuery 1.x for IE 8 support (widget v. 2.x and below),
  • uploadcare.lang.en.js — a bundle without built-in jQuery, en locale only.

Each bundle has its minified version. Just add .min before .js, e.g. uploadcare.min.js.

By default, uploadcare.min.js is exported to NPM and other package managers.



Embed the file uploader client library using the <script> element in the <head> section of each page where you’d like the widget to show up. This CDN link, for instance, embeds the widget version with built-in jQuery,

<script src="" charset="utf-8"></script>

You might also happen to already use jQuery on your page. In this case, consider loading the light widget version without built-in jQuery,

<script src="" charset="utf-8"></script>
<script src="" charset="utf-8"></script>


npm install uploadcare-widget
import uploadcare from 'uploadcare-widget'