Uploading Multiple Files With the Widget

  • 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.

Uploadcare Widget is a File Uploader allowing you to handle multiple files in one go and track progress via individual progress bars.

The multi-uploading behavior is enabled by adding the boolean data-multiple attribute set to true to your widget <input> element, the one having its role specified as role="uploadcare-uploader".

<input type="hidden" role="uploadcare-uploader" name="my_files"

Here is the live widget with multiple file uploads enabled,


Once many files are uploaded, they get stored as a file group. You then get a group_id instead of a file UUID in the value. File group IDs look like this,


File group IDs resemble UUIDs but have a trailing ~N sequence where N stands for the number of files in that group. Depending on your file storing settings, groups can be stored automatically or by making a REST API request.

group_id can be used to address any single file in a group on our CDN,


The latter also means you can apply Image Transformations to individual files in a group,


Note, when trying to access a Group ID via a browser, you will see a list of unique file UUIDs in this group.