Apache Commons logo Commons FileUpload

Commons FileUpload

The Commons FileUpload package makes it easy to add robust, high-performance, file upload capability to your servlets and web applications.

FileUpload parses HTTP requests which conform to RFC 1867, "Form-based File Upload in HTML". That is, if an HTTP request is submitted using the POST method, and with a content type of "multipart/form-data", then FileUpload can parse that request, and make the results available in a manner easily used by the caller.

Starting with version 1.3, FileUpload handles RFC 2047 encoded header values.

The simplest way to send a multipart/form-data request to a server is via a web form, i.e.

<form method="POST" enctype="multipart/form-data" action="fup.cgi">
  File to upload: <input type="file" name="upfile"><br/>
  Notes about the file: <input type="text" name="note"><br/>
  <input type="submit" value="Press"> to upload the file!


The following documentation is available:

You can also browse the Subversion repository.


  • Download the binary and source distributions from the download site.


The Apache Commons mailing lists act as the main support forum. The user list is suitable for most library usage queries. The dev list is intended for development discussion. Please remember that the lists are shared between all commons components, so prefix your e-mail subject line with [fileupload].

Issues may be reported via ASF JIRA.