Dropzone
Search…
Configuration Options
Here is a list of all available options for Dropzone. In case any of this information is outdated (please inform us, if that's the case) or you need more insight, you can always look at the options.js that is used in the actual library.
Name
Default
Description
url
null
Has to be specified on elements other than form (or when the form doesn't have an action attribute). You can also provide a function that will be called with files and must return the url (since v3.12.0)
method
"post"
Can be changed to "put" if necessary. You can also provide a function that will be called with files and must return the method (since v3.12.0).
withCredentials
false
Will be set on the XHRequest.
timeout
null
The timeout for the XHR requests in milliseconds (since v4.4.0). If set to null or 0, no timeout is going to be set.
parallelUploads
2
How many file uploads to process in parallel (See the Enqueuing file uploads documentation section for more info)
uploadMultiple
false
Whether to send multiple files in one request. If this it set to true, then the fallback file input element will have the multiple attribute as well. This option will also trigger additional events (like processingmultiple). See the events documentation section for more information.
chunking
false
Whether you want files to be uploaded in chunks to your server. This can't be used in combination with uploadMultiple. See [chunksUploaded](#config-chunksUploaded) for the callback to finalise an upload.
forceChunking
false
If chunking is enabled, this defines whether **every** file should be chunked, even if the file size is below chunkSize. This means, that the additional chunk form data will be submitted and the chunksUploaded callback will be invoked.
chunkSize
2000000
If chunking is true, then this defines the chunk size in bytes.
parallelChunkUploads
false
If true, the individual chunks of a file are being uploaded simultaneously.
retryChunks
false
Whether a chunk should be retried if it fails.
retryChunksLimit
3
If retryChunks is true, how many times should it be retried.
maxFilesize
256
The maximum filesize (in bytes) that is allowed to be uploaded.
paramName
"file"
The name of the file param that gets transferred. **NOTE**: If you have the option uploadMultiple set to true, then Dropzone will append [] to the name.
createImageThumbnails
true
Whether thumbnails for images should be generated
maxThumbnailFilesize
10
In MB. When the filename exceeds this limit, the thumbnail will not be generated.
thumbnailWidth
120
If null, the ratio of the image will be used to calculate it.
thumbnailHeight
120
The same as thumbnailWidth. If both are null, images will not be resized.
thumbnailMethod
"crop"
How the images should be scaled down in case both, thumbnailWidth and thumbnailHeight are provided. Can be either contain or crop.
Copy link