Registry / Client component

File Upload

A validated file queue with previews, progress, cancellation and retry. Connect your upload service through onUpload.

Installation

Preview

Preview style

    0 uploaded, 0 selected

    Demo progress only. No files leave your browser.

    Usage

    tsx
    "use client"
    
    import { FileUpload } from "@/components/ui/file-upload"
    
    export function UploadDemo() {
      return <FileUpload accept="image/*,.pdf" maxFiles={5} onFilesChange={files => console.log(files)} />
    }

    API reference

    PropTypeDefaultDescription
    acceptstring—Comma-separated MIME types, wildcards or extensions. Validated for drops and file selection.
    maxFilesnumber5Maximum queue length.
    maxSizenumber10485760Maximum size per file in bytes.
    onUploadUploadHandler—Async upload callback receiving the file, AbortSignal and onProgress percentage callback. Without it files stay queued.
    onFilesChange(files: File[]) => void—Receives the current queue after additions and removals.