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.