Skip to main content

Different Configurations

The Uploady component accepts all upload options which are either used to initialize the file input or to initialize the Uploader instance.

To be able to use UI components from this library or any of the hooks it provides, you need to surround the relevant components with an <Uploady> component.

It's recommended that you use a single Uploady component for your entire app. You can configure it with parameters that are relevant for all uploads from your client.

If you need to then override certain options closer to where the actual upload takes place (in your app), you can do that with the provided UI components.


Multiple upload button with different overrides

In this example, the first upload button overrides the 'autoUpload' param. The second upload button adds a header just for uploads initiated by it.

import React from "react";
import Uploady from "@rpldy/uploady";
import UploadButton from "@rpldy/upload-button";

const MyApp = () => {
return <Uploady
destination={{ url: "" }}>

<UploadButton autoUpload={false}>
autoUpload = false
<UploadButton destination={{headers: {"x-test": "1234"}}}>
add 'x-test' header

You can see this in action here.

Multiple drop zone with different overrides

import React from "react";
import Uploady from "@rpldy/uploady";
import UploadDropZone from "@rpldy/upload-drop-zone"
return <Uploady autoUpload
destination={{url: ""}}>

<UploadDropZone autoUpload={false}>
<h2>autoUpload = false</h2>

<UploadDropZone destination={{headers: {"x-test": "1234"}}}>
<h2>add 'x-test' header</h2>

You can see this in action here.