Widget installation

  • This documentation is for the version 3.6.1 of the widget. If you're looking for the widget v2 docs, check here.

When integrating Uploadcare, you’re free to choose from the widget installing methods listed below. You can also check out our libraries and integrations: it’s a good chance to find a ready-made solution for your platform.

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 our client library via the <script> tag 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="https://ucarecdn.com/libs/widget/3.6.1/uploadcare.full.min.js" 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="https://code.jquery.com/jquery-3.2.1.min.js" charset="utf-8"></script>
<script src="https://ucarecdn.com/libs/widget/3.6.1/uploadcare.min.js" charset="utf-8"></script>


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


bower install uploadcare

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.