Skip to content
UI
On this page

File Upload

Selects files for an application to process or upload.

Overview

Copy the source into your project. Import the parts that you need. Styles use local StyleX declarations and shared theme tokens. You can change the source without a wrapper or replacement package.

Preview

File selection with size and type limits

Installation

Run the init command from your project root first. The CLI configures StyleX and installs shared files and dependencies.

Run from your project root. The CLI installs required components, shared files, and packages. Previews may need additional components. The CLI keeps existing files.

Usage

FileUpload selects files. It does not send them. Use label to name the control. The default label is Upload files.

multiple appends files to the selection. Single selection replaces it. Files with the same name, size, lastModified, and type are duplicates. A rejected batch leaves the selection unchanged.

Use accept for comma-separated MIME types or extensions, maxSize for bytes, and maxFiles for a positive file count. Validate files on the server; file metadata can be false.

Use defaultValue for initial files or value and onValueChange for controlled state. The control includes file removal. It is not a native form submission control and does not support name. Append selected files to FormData manually.

Import from the local file installed by the CLI.

API reference

The generator reads the component TypeScript source. Only component and Base UI props appear below. The Required column shows whether you must supply a property. It does not mean you must use the component.

View API reference