Home / JavaScript / File Uploader

File Upload widget with multiple file selection, drag&drop support, progress bar, validation and preview images, audio and video for jQuery. Supports cross-domain, chunked and resumable file uploads. Works with any server-side platform (Google App Engine, PHP, Python, Ruby on Rails, Java, etc.) that supports standard HTML form file uploads.

jQuery File Upload Contents Description Demo Features Security Setup Requirements Mandatory requirements Optional requirements Cross-domain requirements Browsers Desktop brow
Information
Category: JavaScript / File Uploader
Watchers: 1.6k
Star: 31k
Fork: 8.2k
Last update: Mar 19, 2023
Resource links
https://blueimp.github.io/jQuery-File-Upload/
https://github.com/blueimp/jQuery-File-Upload
Popular

jQuery File Upload

Contents

Description

File Upload widget with multiple file selection, drag&drop support, progress bars, validation and preview images, audio and video for jQuery.
Supports cross-domain, chunked and resumable file uploads and client-side image resizing.
Works with any server-side platform (PHP, Python, Ruby on Rails, Java, Node.js, Go etc.) that supports standard HTML form file uploads.

Demo

Demo File Upload

Features

  • Multiple file upload:
    Allows to select multiple files at once and upload them simultaneously.
  • Drag & Drop support:
    Allows to upload files by dragging them from your desktop or file manager and dropping them on your browser window.
  • Upload progress bar:
    Shows a progress bar indicating the upload progress for individual files and for all uploads combined.
  • Cancelable uploads:
    Individual file uploads can be canceled to stop the upload progress.
  • Resumable uploads:
    Aborted uploads can be resumed with browsers supporting the Blob API.
  • Chunked uploads:
    Large files can be uploaded in smaller chunks with browsers supporting the Blob API.
  • Client-side image resizing:
    Images can be automatically resized on client-side with browsers supporting the required JS APIs.
  • Preview images, audio and video:
    A preview of image, audio and video files can be displayed before uploading with browsers supporting the required APIs.
  • No browser plugins (e.g. Adobe Flash) required:
    The implementation is based on open standards like HTML5 and JavaScript and requires no additional browser plugins.
  • Graceful fallback for legacy browsers:
    Uploads files via XMLHttpRequests if supported and uses iframes as fallback for legacy browsers.
  • HTML file upload form fallback:
    Allows progressive enhancement by using a standard HTML file upload form as widget element.
  • Cross-site file uploads:
    Supports uploading files to a different domain with cross-site XMLHttpRequests or iframe redirects.
  • Multiple plugin instances:
    Allows to use multiple plugin instances on the same webpage.
  • Customizable and extensible:
    Provides an API to set individual options and define callback methods for various upload events.
  • Multipart and file contents stream uploads:
    Files can be uploaded as standard "multipart/form-data" or file contents stream (HTTP PUT file upload).
  • Compatible with any server-side application platform:
    Works with any server-side platform (PHP, Python, Ruby on Rails, Java, Node.js, Go etc.) that supports standard HTML form file uploads.

Security

⚠️ Please read the VULNERABILITIES document for a list of fixed vulnerabilities

Please also read the SECURITY document for instructions on how to securely configure your Web server for file uploads.

Setup

jQuery File Upload can be installed via NPM:

npm install blueimp-file-upload

This allows you to include jquery.fileupload.js and its extensions via node_modules, e.g:

<script src="node_modules/blueimp-file-upload/js/jquery.fileupload.js"></script>

The widget can then be initialized on a file upload form the following way:

$('#fileupload').fileupload();

For further information, please refer to the following guides:

Requirements

Mandatory requirements

Optional requirements

Cross-domain requirements

Cross-domain File Uploads using the Iframe Transport plugin require a redirect back to the origin server to retrieve the upload results. The example implementation makes use of result.html as a static redirect page for the origin server.

The repository also includes the jQuery XDomainRequest Transport plugin, which enables limited cross-domain AJAX requests in Microsoft Internet Explorer 8 and 9 (IE 10 supports cross-domain XHR requests).
The XDomainRequest object allows GET and POST requests only and doesn't support file uploads. It is used on the Demo to delete uploaded files from the cross-domain demo file upload service.

Browsers

Desktop browsers

The File Upload plugin is regularly tested with the latest browser versions and supports the following minimal versions:

  • Google Chrome
  • Apple Safari 4.0+
  • Mozilla Firefox 3.0+
  • Opera 11.0+
  • Microsoft Internet Explorer 6.0+

Mobile browsers

The File Upload plugin has been tested with and supports the following mobile browsers:

  • Apple Safari on iOS 6.0+
  • Google Chrome on iOS 6.0+
  • Google Chrome on Android 4.0+
  • Default Browser on Android 2.3+
  • Opera Mobile 12.0+

Extended browser support information

For a detailed overview of the features supported by each browser version and known operating system / browser bugs, please have a look at the Extended browser support information.

Testing

The project comes with three sets of tests:

  1. Code linting using ESLint.
  2. Unit tests using Mocha.
  3. End-to-end tests using blueimp/wdio.

To run the tests, follow these steps:

  1. Start Docker.
  2. Install development dependencies: 
    npm install
  3. Run the tests: 
    npm test

Support

This project is actively maintained, but there is no official support channel.
If you have a question that another developer might help you with, please post to Stack Overflow and tag your question with blueimp jquery file upload.

License

Released under the MIT license.

49 Open More issues
Closed

Error: SyntaxError: Unexpected token <

Hi im trying to upload images files but everytime i push upload

i get this - Error: SyntaxError: Unexpected token <

pleas help and thx for any help.

opened Sep 25, 2011 by Dacarts 56
Closed

Upload multiple files directly to S3?

I have been using Jquery-file-upload plugin with paperclip and S3 for quite a while now and I really like it. However, as the files I need to upload become bigger, uploading directly to S3 becomes my only choice.

This article demonstrates how to upload a single file to S3, unfortunately it doesn't do multiple files uploading.
https://github.com/blueimp/jQuery-File-Upload/wiki/Upload-directly-to-S3

so my question is, is it possible to iterate through a list of files and create a single post form for each file on the fly?

Or is it possible to create an independent form and then repopulate the field in each iteration?

Any tips are greatly appreciated.

opened Dec 29, 2011 by Kickyourassforever 50
Closed

Retain EXIF and ICC headers with client-side image processing

It seems like it should be possible to retain the ICC and EXIF data by extracting the APP2 segment data from the original image and re-attach it to the resized image.

ICC Color Profiles? For those unfamiliar, let me explain: Perhaps you have heard of sRGB, RGB, CMYK, etc. These are color mappings that instruct devices how to render the colors. When this data is stripped from the image, the colors get all fucked up. Eg. CMYK image is upload, profile is stripped, server displays image, browser reads is as untagged RGB, displays in sRGB color space, resulting wrong colors. Blues shift to purple, grey to black, etc.

Normally the best way to manage mismatched color spaces is through conversion with Image Magick (reading the source profile and then converting to sRGB, which is a standardized color profile for computer monitors).

However, once the image has the ICC profile stripped with Canvas resize, the conversion cannot be peformed in Image magick because the original color space is unknown.

I've seen a solution for this (Grabbing the ICC info from the JPG header and reinserting it) in pupload: https://github.com/moxiecode/plupload/blob/master/src/javascript/plupload.html5.js

However, I have been unsuccessful thus far in integrating it.

feature 
opened Apr 16, 2012 by edeis 38
Closed

All works but "Empty file upload result" error appears

I'm using basic example and keep getting "Empty file upload result" error although all files are uploading correctly. I checked permissions for "files" and "thumbnails" folders - it's okay too (I tried 775 and 777). Can somebody help me?

opened Jun 3, 2011 by michellekg 36
Closed

Problems with iframe upload

So I had the uploader setup and working just fine, or so I thought ... turns out it didn't work in IE because it (in all its iterations) does not support AJAX uploads. So I've been trying to get it to work with the options 'forceIframeTransport' set to true.

I have the basic plugin included, the iframe-transport file too ... and I have the upload script on the server returning text/html as advised in the documentation. I have it working ... almost ... all the variables are getting sent to the server properly except the actual file and I can't figure out why.

At first I thought it was just an IE thing, but with the 'forceIframeTransport' option set to true, google Chrome is doing the same thing.

I 'm worried that I might not fully understand what 'The Iframe Transport requires a file input selection to upload files.' means. I have a file input, which I'm using to add file info to the UI for each file selection ... is there something I'm missing?

opened Sep 21, 2011 by concept47 33
Closed

Problem with new codeigniter example

Hello, I tried to setup codeigniter with new example, but I keep getting error when I click "Start Upload": Unable to load the requested file: upload.php

Images are uploaded in the uploads file, but the error is there (setup I made is the same as one in the example). Also, at the end of example author put following line: I had a problem with seeing images/thumbnails initially then I realized I had not set uploads/ directory in my .htacces file

I am new to .htacces, so I don't know how to do this part. Can someone help me?

opened Feb 20, 2012 by Brav 31
Closed

Plugin does not initialize with Version 5.0

When I'm trying to initialize the plugin on the file upload control

if('undefined' !== $.type($('input[type=file][name=userfile]')[0])) {
    var file_input = $('input[type=file][name=userfile]');

    file_input.fileUploadUI({
        uploadTable: $('#files'),
        buildUploadRow: function (files, index, handler) {
            return $('<tr><td>' + files[index].name + '<\/td>' +
                    '<td class="file_upload_progress"><div><\/div><\/td>' +
                    '<td class="file_upload_cancel">' +
                    '<button class="ui-state-default ui-corner-all" title="Cancel">' +
                    '<span class="ui-icon ui-icon-cancel">Cancel<\/span>' +
                    '<\/button><\/td><\/tr>');
        },
    });
}

it says: file_input.fileUploadUI is not a function

All the dependencies are present, either css or js files, Firebug shows them loaded and ready to run.

Some info: I'm using it in SugarCRM environment, so I've added the links to the files into the head part of the page, where the scripts and styles normally should be. The idea was to apply and initialize it to file upload control programmatically only in the case, when this control is present in the form. I don't want to apply this plugin to the whole form because this form is a part of Wizard step and any intervention into the form's normal functionality will destroy the wizard logic. The only task, the plugin can do for me is form-independent upload of the imported file before the user goes to the next Wizard step.

Also, the Steps load themselves via AJAX ($('#content_td').html(xhr.responseText)), so there is no place for $(function) like in the examples, because it requires the page to be reloaded to initialize it.

If it is not a bug and I'm doing anything wrong, please help me to figure out what it exactly is. Thank you.

opened May 17, 2011 by gadeshi 30
Open

$.type is deprecated

Using $.type is deprecated according to the jQuery Migration 3.3.2 tool.

See: https://github.com/jquery/jquery-migrate/blob/main/warnings.md#jqmigrate-jquerytype-is-deprecated

Cause: This method returns a string that indicates the type of the argument, for example "number" or "function". However, as the JavaScript language evolves this method has become problematic because new language constructs might require this function to either return a new string (potentially breaking existing code) or somehow map new constructs into existing strings (again, potentially breaking existing code). Examples of new recent JavaScript features include asynchronous functions, class constructors, Symbols, or functions that act as iterators.

Solution: Review code that uses jQuery.type() and use a type check that is appropriate for the situation. For example. if the code expects a plain function, check for typeof arg === "function".

opened Sep 5, 2021 by melloware 2
Open

Client side resize bad aliasing depending on browser

Hello,

This is not so much a "bug" as trying to learn about something we observe and maybe understanding if there can be improvements.

We use client side resize in jquery upload to resize images to around 1200x825px height.

We've noticed that Firefox and Chrome have noticeably different image quality after resize, but both leave much more aliasing in angled lines than server side Imagick does with its default filters (Lanczos or Mitchell).

Is this something that can be improved somehow? Are some browsers better than others with client side resize, and what are they?

I took an image and uploaded with client side resize off, then with it "on" in Chrome and Firefox, and I cropped out a section from each sample to demonstrate the most obvious artifacts:

example_resize_jqueryupload

The angled line is the most obvious, but even if you look at the "psb speakers" logo you can clearly see the Imagic resize is cleaner than the other two, especially compared to Firefox which has the worst resize.

Is there any way to set the client side resize to use better or different resize algorithms?

feature 
opened Apr 6, 2021 by redemption 2
Open

Deprecated function usage in jquery-ui

There's been some work towards removing deprecated function usage over the last few months. It seems the below haven't been pointed out before, so here goes:

jQuery.isArray is deprecated; use Array.isArray

  • https://github.com/blueimp/jQuery-File-Upload/blob/f5d629abdaf480fefad8ad823cb1e2c96805bd4e/js/jquery.fileupload-ui.js#L86

jQuery. isFunction() is deprecated. In most cases, its use can be replaced by typeof x === "function"

  • https://github.com/blueimp/jQuery-File-Upload/blob/d2535157e6005eb3c37f7d0b0042462393139c5b/js/vendor/jquery.ui.widget.js#L134
  • https://github.com/blueimp/jQuery-File-Upload/blob/d2535157e6005eb3c37f7d0b0042462393139c5b/js/vendor/jquery.ui.widget.js#L276
opened Aug 12, 2020 by bytestream 16
Open

Provide minified version

I couldn't find a minified version of this project. I think this might be a main blocker for people trying to use it in theirs project.

feature 
opened Aug 12, 2020 by pbartoszek 2
Open

Callback after bulk delete

Bulk delete implementation simply looks up delete buttons of selected items in file list and triggers click on them.

https://github.com/blueimp/jQuery-File-Upload/blob/master/js/jquery.fileupload-ui.js#L638

Would be great if the delete requests get tracked and an event gets fired after bulk deletion completes.

Usecase is reloading of some parts of the page after bulk delete.

feature 
opened Jul 6, 2020 by rnixx 1
Open

Colors are changed when using Client-Side image resize

Hello,

When I'm uploading the attached photo and resizing the image using the 'imageMaxWidth' and 'imageMaxHeight' options, the image's colors are changed.

When I'm not using the above options or set them to 'Number.MAX_SAFE_INTEGER', the colors are the same as the original image.

Here is the original image: 20_Nis_Rogue_Sport-039-source

Here is the result after uploaded to your demo site (which using 'imageMaxWidth' and 'imageMaxHeight'):

bug 
opened Jun 18, 2020 by cb-eli 1
Open

Way to upload Heic files and automatically transform it into jpg

Hello good morning with the new format that is available in some devices I would like to know if, as well as when capturing a photo, the same plugin transforms the image to jpg, if there is an identical way to upload files saved in heic format, transform it to jpg?

Greetings,

feature 
opened May 15, 2020 by kainpro 4

Contents

    lian-yue vue-upload-component - Vue upload component, Multi-file upload, Upload directory, Drag upload, Drag the directory. Supports Vue >= 2.0
    jsplumb Lightweight drag/drop handler, supporting containment, multiple element drag, custom css classes, drop filters, drag filters.
    ankitpokhrel 🚀 A pure PHP server and client for the tus resumable upload protocol v1.0.0
    tus A pure JavaScript client for the tus resumable upload protocol
    provejs An event based jQuery plugin for client-side validation of html forms.
    s1modev Vue 3 component for multiple images upload with preview.
    kartik-v An enhanced HTML 5 file input for Bootstrap 4.x./3.x with file preview, multiple selection, and more features.
    TerryZ v-uploader - A Vue2 plugin to make files upload simple and easier, you can drag files or select file in dialog to upload
    toolinbox Use iPic to upload images on macOS.
    nnluukhtn Form Animation: when form validation <3 animate.css
    flowjs A JavaScript library providing multiple simultaneous, stable, fault-tolerant and resumable/restartable file uploads via the HTML5 File API.
    jquery-validation jQuery Validation Plugin library sources
    opoloo This is a small jQuery plugin, which provides a live preview of selected files before they're actually uploaded to the server.
    HerMajestyDrMona "Windows 11 Drag & Drop to the Taskbar (Partial Fix)" partially fixes the missing "Drag & Drop to the Taskbar" support in Windows 11. It works with the new Windows 11 taskbar and does not require nasty changes like UndockingDisabled or restoration of the classic taskbar.
    HerMajestyDrMona "Windows 11 Drag & Drop to the Taskbar (Partial Fix)" partially fixes the missing "Drag & Drop to the Taskbar" support in Windows 11. It works with the new Windows 11 taskbar and does not require nasty changes like UndockingDisabled or restoration of the classic taskbar.
    MohammadAminZamaniAfshar A widget that allow user resize the widget with drag
    toolinbox iPic could automatically upload images and save Markdown links.
    airjp73 Form component and utils for easy form validation in remix
    TerryZ v-selectpage - A powerful selector for Vue2, list or table view of pagination, use tags for multiple selection, i18n and server side resources supports.
    james2doyle A for Vue.js directive for providing drag and drop capabilities to elements and data
    yangyxd Flutter Image add drag sort, Image add drag sort, support click event, delete, add, long press drag sort.
    Share this repo

    Related Repos


    File Uploader
    3
    Upload books to Library genesis
    fawazahmed0 Libgen Books Uploader In the name of God, who have guided me to do this work Please star this repo by clicking on ⭐ button above ↗️ Features: Batch up
     
    File Uploader
    3
    🪴 o!rdr command line tool to upload replays to it from the terminal
    TorchedSammy Holly 🪴 o!rdr command line tool to upload replays to it from the terminal Holly is a CLI that allows you to upload osu! replays to o!rdr from the ter
     
    File Uploader
    22
    Useful HTML file upload tips for web developers
    atapas Useful HTML file upload tips for web developers
     
    File Uploader
    1.1k
    jQuery Ajax File Uploader Widget
    danielm A lightweight and very configurable jQuery plugin for file uploading using ajax(a sync); includes support for queues, progress tracking and drag and drop.
     
    File Uploader
    15
    GraphQL Client with file upload support for NodeJS and browser
    lynxtaa GraphQL Client with file upload support for NodeJS and browser
     
    File Uploader
    1.8k
    📁 Uppload is a better JavaScript image uploader with 30+ plugins
    elninotech Uppload is a better JavaScript image uploader. It's highly customizable with 30+ plugins, completely free and open-source, and can be used with any file uploading backend. Status Build
     
    File Uploader
    36
    Upload images to sm.ms
    metowolf Upload images to sm.ms
     
    File Uploader
    45
    Upload a file to S3.
    ungoldman nano-s3 Upload a file to S3. About Sometimes you just need a small lib to do a simple task. uploads a file to s3 that's it no other features very small! 7.4 KB unpacked compare to aws-sdk's
     
    File Uploader
    29
    📦 Tinypng desktop application, upload compress image to server simply
    muwoo 📦 Tinypng desktop application, upload compress image to server simply
     
    File Uploader
    380
    DropIt is a File Uploader built with nodejs, Upload, get a link, and share your files with...
    ThalKod DropIt DropIt is a File Uploader built with nodejs Demo 💾 Installation # clone the repo $ git clone https://github.com/ThalKod/DropIt.git # install the node modules... $ npm install Usage
     
    File Uploader
    8.2k
    Multiple file upload plugin with image previews, drag and drop, progress bars. S3 and Azur...
    FineUploader Documentation | Examples | Support | Blog | Changelog Fine Uploader is: Cross-browser Dependency-free 100% JavaScript 100% Free Open Source Software FineUploader is also simple to use. In the simplest case, you onl
     
    File Uploader
    1.7k
    🔌 A handy FilePond adapter component for Vue
    pqina Vue FilePond Vue FilePond is a handy adapter component for FilePond, a JavaScript library that can upload anything you throw at it, optimizes images for faster uploads, and offers a great, accessible, silky smooth user experience
     
    File Uploader
    13.5k
    🌊 A flexible and fun JavaScript file upload library
    pqina A Flexible and Fun JavaScript File Upload Plugin Beautiful animations, fast uploads with client-side image optimization, and a great, accessible, user experience. Learn more about FilePond Quick Start
     
    File Uploader
    75
    Drag and drop multiple file uploader with Vue.js v2 and Axios
    abarta MOVED: https://github.com/updivision/vue2-multi-uploader vue2-multi-uploader A drag and drop multiple file uploader component that uses Vue.js v2 and Axios. Uploader shows file names, sizes and total size of files a
     
    File Uploader
    243
    Open source Web File Manager (Javascript + VueJS 2)
    iutbay Media Manager Media Manager is an open source web file manager and can be a nice alternative to Wordpress Media Manager, CKFinder, KCFinder, elFinder... It is still in its early stages, but feel free to use it, report bugs an