React File Uploader

In React, you can integrate Uploadcare File Uploader in two ways:

• with Web Components (@uploadcare/file-uploader)
• with the React adapter (@uploadcare/react-uploader)

When to choose each option

Web Components package

Choose this when you want direct access to uploader elements, events, and low-level API.

• Package: @uploadcare/file-uploader
• Core docs: File Uploader

React adapter package

Choose this when you prefer React component APIs and React-centric state/event bindings.

• Package: @uploadcare/react-uploader

Examples

Web Components

• Source on GitHub

 

React adapter

• Source on GitHub

 

Related File Uploader docs

• Installation
• Configuration
• Events
• API
• Styling
• Plugin API

React-specific notes

• If you use Web Components directly, subscribe/unsubscribe to uploader events in React effects.
• Keep uploader state updates predictable by committing only successful entries to app state.
• If your app uses strict CSP or secure uploads, review Security settings.