List & Common Options
Plugins are what makes Uppy useful: they help select, manipulate and upload files.
- Acquirers (neat UIs for picking files):
- Dashboard — full featured sleek UI with file previews, metadata editing, upload/pause/resume/cancel buttons and more
- DragDrop — plain and simple drag and drop area
- FileInput — even more plain and simple, just a button
- Provider Plugins (remote sources that work through Uppy Server): Instagram, GoogleDrive, Dropbox
- Tus10 — uploads using the tus resumable upload protocol
- XHRUpload — classic multipart form uploads or binary uploads using XMLHTTPRequest
- AwsS3 — uploader for AWS S3
- ProgressBar — add a small YouTube-style progress bar at the top of the page
- StatusBar — advanced upload progress status bar
- Informer — show notifications
- GoldenRetriever — restore files and continue uploading after a page refresh or a browser crash
- Encoding Services:
Each plugin can have any number of options (please see specific plugin for details), but these are shared between some:
Can be a
string CSS selector, a DOM element, or a Plugin class. Consider the following example, where
DragDrop plugin will be rendered into a
While in this one, we are using the
Dashboard plugin, which can act as a host target for other plugins:
In the example above the
Dashboard gets rendered into an element with ID
GoogleDrive is rendered into the
Used by uploader plugins, such as Tus and XHRUpload. Expects a
string with a url that will be used for file uploading.
Used by remote provider plugins, such as Google Drive, Instagram or Dropbox. Specifies the url to your running
uppy-server. This allows uppy to know what server to connect to when server related operations are required by the provider plugin.
setMetaFromTargetForm === true, UI acquire type plugins, like Dashboard, FileInput and DragDrop, before mounting themselves or doing anything else, will extract FormData from the target
<form> element (it must be a form currently), and merge the object with the global
If you have a form like this one:
And then do:
uppy.state.meta will become:
By default Uppy will append any UI to a DOM element, if such element is specified as a
target. This default is the least dangerous option. However, you might want to provide fallback
replaceTargetContent: true to clear the
target before appending, that way all your fallback elements will be removed if Uppy is actually functioning.
Same as with Uppy.Core’s setting from above, this allows you to override plugin’s local string, so that instead of
Select files in English, your users will see
Выберите файлы in Russian. Example:
See plugin documentation pages for other plugin-specific options.
The Provider plugins help you connect to your accounts with remote file providers such as Dropbox, Google Drive, Instagram. Because this requires server to server communication, they work tightly with uppy-server to manage the server to server authroization for your account. Virtually most of the communication (file download/upload) is done on the server-to-server end, so this saves you the stress of data consumption on the client.
As of now, the supported providers are Dropbox, GoogleDrive, and Instagram.
Usage of the Provider plugins is not that different from any other acquirer plugin, except that it takes an extra option
host, which specifies the url to your running
uppy-server. This allows Uppy to know what server to connect to when server related operations are required by the provider plugin. Here’s a quick example.