Allowed formats
Use the allowedFormats prop to define which file types Drop Upload accepts,
as an array of MIME types. Files whose declared type doesn't match the list
are rejected as soon as they're dropped or selected — they still appear in
attachedFiles (with status: "rejected" and a rejectionReason) so the
user sees them flagged in the list, but they are never uploaded.
<DropUpload allowedFormats={["image/png", "image/jpeg"]} />Not sure which MIME type to use? Check the IANA Media Types list or mimetype.io.
Wildcards
Group formats with wildcards instead of listing every MIME type:
<DropUpload allowedFormats={["image/*"]} />Supported wildcards: image/*, video/*, audio/*, text/*, font/*,
application/*.
Multiple formats
Specific types and wildcards can be combined freely in the same list:
<DropUpload
allowedFormats={[
"image/png",
"image/jpeg",
"video/*",
"audio/*",
"font/ttf",
"font/otf",
]}
/>Label modes
allowedFormatsLabelMode controls how the allowed formats are described to
the user:
| Value | Behavior |
|---|---|
"auto" (default) | Shows one representative extension per MIME type (e.g. PNG) |
"auto-extended" | Shows every extension that matches each MIME type |
"custom" | Shows the text you provide in allowedFormatsLabelCustomText |
"off" | Hides the format instructions entirely |
Use "custom" to override the auto-generated label with your own text:
<DropUpload
allowedFormats={["image/jpeg"]}
allowedFormatsLabelMode="custom"
allowedFormatsLabelCustomText="Cute cat pics only!"
/>If you've used the previous documentation, note the correct value is
"auto-extended", not "auto-full".