> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://uploadcare.com/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://uploadcare.com/docs/_mcp/server.

# React File Uploader

> Integrate Uploadcare File Uploader in React using Web Components or the React adapter.

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](https://www.npmjs.com/package/@uploadcare/file-uploader)
* Core docs: [File Uploader](/docs/file-uploader/)

### React adapter package

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

* Package: [@uploadcare/react-uploader](https://www.npmjs.com/package/@uploadcare/react-uploader)

## Examples

### Web Components

* [Source on GitHub](https://github.com/uploadcare/file-uploader-examples/tree/main/examples/react-uploader)

[![Play with CodeSandbox](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/p/devbox/github/uploadcare/file-uploader-examples/tree/main/examples/react-uploader)

[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/uploadcare/file-uploader-examples/tree/main/examples/react-uploader)

### React adapter

* [Source on GitHub](https://github.com/uploadcare/file-uploader-examples/tree/main/examples/react-uploader-adapter)

[![Play with CodeSandbox](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/p/devbox/github/uploadcare/file-uploader-examples/tree/main/examples/react-uploader-adapter)

[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/uploadcare/file-uploader-examples/tree/main/examples/react-uploader-adapter)

## Related File Uploader docs

* [Installation](/docs/file-uploader/installation/)
* [Configuration](/docs/file-uploader/configuration/)
* [Events](/docs/file-uploader/events/)
* [API](/docs/file-uploader/api/)
* [Styling](/docs/file-uploader/styling/)
* [Plugin API](/docs/file-uploader/plugins/)

## 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](/docs/file-uploader/security/).