# @fortawesome/fa-icon-chooser-react

> React specific wrapper for @fortawesome/fa-icon-chooser

Latest version **0.11.0** (published 2026-07-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install @fortawesome/fa-icon-chooser-react
pnpm add @fortawesome/fa-icon-chooser-react
yarn add @fortawesome/fa-icon-chooser-react
bun add @fortawesome/fa-icon-chooser-react
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.11.0 |
| Published | 2026-07-17 |
| First published | 2021-08-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 5.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 23 |
| Maintainers | devoto13, jrjohnson, robmadole, supercodepoet, fortawesome-admin, mwilkerson, jasonlundien, lordofbacon |

## Links

- npm: https://www.npmjs.com/package/@fortawesome/fa-icon-chooser-react
- Repository: https://github.com/FortAwesome/fa-icon-chooser
- Homepage: https://github.com/FortAwesome/fa-icon-chooser#readme
- Issues: https://github.com/FortAwesome/fa-icon-chooser/issues
- npm.io page: https://npm.io/package/@fortawesome/fa-icon-chooser-react

## Dependencies (2)

- [@fortawesome/fa-icon-chooser](https://npm.io/package/@fortawesome/fa-icon-chooser.md) 0.11.0
- [@stencil/react-output-target](https://npm.io/package/@stencil/react-output-target.md) ^0.8.2

## Recent versions

- 0.11.0 (latest) — 2026-07-17
- 0.10.0-2 (pre) — 2025-12-10
- 0.9.0-2 (alpha) — 2025-05-24
- 0.3.0-rc1 (next) — 2022-01-26
- 0.10.2 — 2026-05-05
- 0.10.0 — 2026-04-01
- 0.9.1 — 2025-07-22
- 0.9.0 — 2025-07-22
- 0.9.0-3 — 2025-07-21
- 0.9.0-1 — 2025-05-23
- 0.8.0 — 2025-02-14
- 0.8.0-7 — 2025-02-14
- 0.8.0-5 — 2025-02-13
- 0.8.0-1 — 2024-07-11
- 0.7.0 — 2024-06-05
- … 8 more at https://npm.io/package/@fortawesome/fa-icon-chooser-react/versions

## README

# FaIconChooser React Component

Find API References for the required callback functions in the [`fa-icon-chooser` component documentation over here](../fa-icon-chooser/src/components/fa-icon-chooser/readme.md).

## Usage

```
npm install --save @fortawesome/fa-icon-chooser-react
```

```js
import ReactDOM from 'react-dom'
import { FaIconChooser } from '@fortawesome/fa-icon-chooser-react'

// One or both of these would be provided somehow by the user.
// If both are provided as propse, kitToken takes priority over version.
// If only version is present, the Icon Chooser will run with only
// Font Awesome Free with the given version.
const version = '5.15.5'
const kitToken = undefined

// Implement the required callback functions.

function handleQuery() {
  // ...
}

function handleResult() {
  // ...
}

function getUrlText() {
  // ...
}

const chooser = <FaIconChooser
  version={ version }
  kitToken={ kitToken }
  handleQuery={ handleQuery }
  getUrlText={ getUrlText }
  onFinish={ handleResult }
></FaIconChooser>

ReactDOM.render(chooser, document.body)
```

See also the [example React app](example).

---
_Source: https://npm.io/package/@fortawesome/fa-icon-chooser-react · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._