# React Font Awesome changelog

> The React component for Font Awesome icons.

- Vendor: Fonticons
- Category: Frameworks & Libraries
- Official site: https://github.com/FortAwesome/react-fontawesome
- Tracked by: What's New (https://whatsnew.fyi/product/react-fontawesome)
- Harvested from: GitHub (FortAwesome/react-fontawesome)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v3.5.0

- Date: 2026-07-20
- Version: v3.5.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.5.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.5.0

- **added** — Add new canvas options

##### [3.5.0](https://github.com/FortAwesome/react-fontawesome/compare/v3.4.0...v3.5.0) (2026-07-20)

###### Features

* add new canvas options ([c5333b9](https://github.com/FortAwesome/react-fontawesome/commit/c5333b9abb30cefa989c367dc4541073eb48bf73))

###### Chores

* **deps:** roll back commitlint to fix release notes generation ([d5f3376](https://github.com/FortAwesome/react-fontawesome/commit/d5f33764b6b882e5fbb59c90041c046034af07e5))
* fix missing changelog for 3.4.0 ([e33cff5](https://github.com/FortAwesome/react-fontawesome/commit/e33cff5fd78cefb62a1d2cfefc378419d02843fd))

### v3.4.0

- Date: 2026-07-08
- Version: v3.4.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.4.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.4.0

- **added** — Support for new animations introduced in FontAwesome v7.3.0

##### [3.4.0](https://github.com/FortAwesome/react-fontawesome/compare/v3.3.1...v3.4.0) (2026-07-08)

###### Features

* Support for new animations introduced in FontAwesome v7.3.0 (#651)

###### Chores

* **deps:** bump fast-uri from 3.1.0 to 3.1.2 (https://github.com/FortAwesome/react-fontawesome/commit/a193c1180b7165dbcf99640ddbdfa00591ebcfdb)
* **deps-dev:** bump dev dependencies to use FA 7.3.0 (https://github.com/FortAwesome/react-fontawesome/commit/cc540d8094760e2b5d6f326c6b5b97ac14d94c62)


**Full Changelog**: https://github.com/FortAwesome/react-fontawesome/compare/v3.3.1...v3.4.0

### v3.3.1

- Date: 2026-04-20
- Version: v3.3.1
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.3.1
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.3.1

- **security** — Bump handlebars from 4.7.8 to 4.7.9 to close CVEs
- **security** — Bump lodash-es from 4.17.23 to 4.18.1 to close CVEs
- **security** — Bump picomatch from 2.3.1 to 2.3.2 to close CVEs
- **security** — Bump lodash from 4.17.23 to 4.18.1 to close CVEs
- **changed** — Bump Node to 22.22.2 and all dev dependencies

##### [3.3.1](https://github.com/FortAwesome/react-fontawesome/compare/v3.3.0...v3.3.1) (2026-04-20)

Just a few dependency bumps to close off CVEs (not that our lib is really affected anyway).

###### Chores

* **deps-dev:** bump handlebars from 4.7.8 to 4.7.9 ([f1d6d94](https://github.com/FortAwesome/react-fontawesome/commit/f1d6d943d0f1a014c5cec77d244fc021c0a09c93))
* **deps-dev:** bump lodash-es from 4.17.23 to 4.18.1 ([212496a](https://github.com/FortAwesome/react-fontawesome/commit/212496a5b3cc2a054da0400db608296e8ac59c4c))
* **deps-dev:** bump picomatch from 2.3.1 to 2.3.2 ([557ceaf](https://github.com/FortAwesome/react-fontawesome/commit/557ceaf5f47b45df48bb70385ecbe54aa0eb340f))
* **deps:** bump lodash from 4.17.23 to 4.18.1 ([2d06890](https://github.com/FortAwesome/react-fontawesome/commit/2d06890530c90d019f33b5c361f436deb13261f9))
* **deps:** node 22.22.2, bump all dev dependencies ([99ba500](https://github.com/FortAwesome/react-fontawesome/commit/99ba500ede9a68c3973c1fe0d6c2475d9d40b699))

### v3.3.0

- Date: 2026-03-20
- Version: v3.3.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.3.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.3.0

- **added** — Support for custom gradient fills
- **added** — API Reference documentation

##### [3.3.0](https://github.com/FortAwesome/react-fontawesome/compare/v3.2.0...v3.3.0) (2026-03-20)

###### Highlights:

* Added Custom Gradient Support! (see PR #625 and Issue #368)
* Added new API Reference documentation! (see https://fortawesome.github.io/react-fontawesome/)

###### Features

* feat(style): add support for custom gradient fills by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/625

###### Chores

* chore(docs): add typedoc-generated API reference docs by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/631
* chore(docs): clean up API docs output structure, rewrite html links by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/632

###### CI/CD

* ci(publish): enable publishing releases from CI by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/623
* ci(actions): update deprecated actions by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/633
* ci(actions): fix publish action env setting by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/634

**Full Changelog**: https://github.com/FortAwesome/react-fontawesome/compare/v3.2.0...v3.3.0

### v3.2.0

- Date: 2026-02-06
- Version: v3.2.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.2.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.2.0

- **added** — Export CSSVariables type for user consumption
- **fixed** — Support for defined process but undefined process.env
- **deprecated** — The title and titleId props are deprecated
- **changed** — Spread operator order changed to allow given props to override

##### [3.2.0](https://github.com/FortAwesome/react-fontawesome/compare/v3.1.1...v3.2.0) (2026-02-06)

###### Features

* feat(types): export CSSVariables type for user consumption by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/622

###### Bug Fixes

* fix(env): support for defined process but undefined process.env by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/616

###### Chores

* Add a deprecation notice to the `title` and `titleId` props by @vivshaw in https://github.com/FortAwesome/react-fontawesome/pull/612
* chore(deps): upgrade all dev deps by @charles4221 in https://github.com/FortAwesome/react-fontawesome/pull/621
* Switch order of spread to allow given props to override by @robmadole in https://github.com/FortAwesome/react-fontawesome/pull/615

##### New Contributors
* @vivshaw made their first contribution in https://github.com/FortAwesome/react-fontawesome/pull/612

**Full Changelog**: https://github.com/FortAwesome/react-fontawesome/compare/v3.1.1...v3.2.0

### v3.1.1

- Date: 2025-11-28
- Version: v3.1.1
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.1.1
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.1.1

- **fixed** — Allow custom role attribute on SVGs like previous versions
- **security** — Fix GH advisory GHSA-5j98-mcp5-4vw2

##### [3.1.1](https://github.com/FortAwesome/react-fontawesome/compare/v3.1.0...v3.1.1) (2025-11-28)

###### Bug Fixes

* **WCAG:** allow custom role attribute on svgs like previous versions ([ef4986b](https://github.com/FortAwesome/react-fontawesome/commit/ef4986b06a3ef922b21d12453fc0b8fc62e2bcd0))

###### Documentation

* remove irrelevant upgrade guide from 0.1-0.2x ([7d41077](https://github.com/FortAwesome/react-fontawesome/commit/7d4107742ce7d58a239a1b87b7f95606c576c182))

###### Chores

* **deps:** fix GH advisory GHSA-5j98-mcp5-4vw2 ([2cd0c3f](https://github.com/FortAwesome/react-fontawesome/commit/2cd0c3f838bb97f9e0f8ec13339cd5ef445f15fe))
* **deps:** regenerate lockfile ([779488e](https://github.com/FortAwesome/react-fontawesome/commit/779488ed84d4ecf18b0aadeb830272a4f2eb5f34))
* **deps:** upgrade all dev deps ([b92e5a7](https://github.com/FortAwesome/react-fontawesome/commit/b92e5a703fedc311f38007fd5e83f3b09145b8d9))
* **release:** explicit registry in publish script ([2aee952](https://github.com/FortAwesome/react-fontawesome/commit/2aee952ec61f00c31e4cfc2893042faac553ee9d))
* **release:** fix semantic release config missing npm plugin ([ebabf46](https://github.com/FortAwesome/react-fontawesome/commit/ebabf46f81dd03cea2d1b429be9253754daca34d))

### v3.1.0

- Date: 2025-10-03
- Version: v3.1.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.1.0

- **added** — Add custom cssPrefix support
- **added** — Add support for layers with FontAwesomeLayers component
- **fixed** — Improve export path for CustomPrefixProvider
- **fixed** — Fix Safari 12 support by avoiding string.replaceAll

##### [3.1.0](https://github.com/FortAwesome/react-fontawesome/compare/v3.0.2...v3.1.0) (2025-10-03)

###### Features

* custom cssPrefix support ([ad42835](https://github.com/FortAwesome/react-fontawesome/commit/ad42835fccc8d5d5eb1af9da4417ad9c51612bd6))
* **layers:** add support for layers with FontAwesomeLayers component ([2c84902](https://github.com/FortAwesome/react-fontawesome/commit/2c84902442bf36a564896ef51d56f3551bf0b303))

###### Bug Fixes

* better export path for CustomPrefixProvider ([663cd25](https://github.com/FortAwesome/react-fontawesome/commit/663cd25881af8b631cf2212bb50970be339f9af2))
* **browser-support:** don't use string.replaceAll to fix safari 12 support ([1776e3a](https://github.com/FortAwesome/react-fontawesome/commit/1776e3a35bfc1e0ad17d783036cd16bc3791add3))

###### Testing

* **layers:** add unit tests for FontAwesomeLayers ([d31480b](https://github.com/FortAwesome/react-fontawesome/commit/d31480b118855fc727ed1c8a2dd1fdbf9ddc426e))
* **utils:** unit tests for withPrefix utility ([982f649](https://github.com/FortAwesome/react-fontawesome/commit/982f649820d0ea14537d7a21812e561ec4dc8b9d))

###### Documentation

* add inline documentation for CustomPrefixProvider ([46f69d4](https://github.com/FortAwesome/react-fontawesome/commit/46f69d4509e71a0db56ac8e90757cde6628fc375))
* remove .env requirement ([c942c6a](https://github.com/FortAwesome/react-fontawesome/commit/c942c6a5f054fa298e8e6d5214635e38fea78e1e))

###### Chores

* **release:** use @semantic-release/exec for multi-publish rather than third-party plugin ([5a47e13](https://github.com/FortAwesome/react-fontawesome/commit/5a47e1398b2de84e460b5b666dee884b123fb62e))

### v3.0.2 — Release 3.0.2

- Date: 2025-09-01
- Version: v3.0.2
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.0.2
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.0.2

- **fixed** — Resolve JSON import errors for vite/remix users
- **fixed** — Correctly read aria-label and ensure aria-hidden is false when label present
- **removed** — Remove dependency on semver

##### [3.0.2](https://github.com/FortAwesome/react-fontawesome/compare/v3.0.1...v3.0.2) (2025-09-01)

###### Bug Fixes

- **constants:** resolve JSON import errors for vite/remix users ([850a804](https://github.com/FortAwesome/react-fontawesome/commit/850a804011ad4852b10241ecad195b5f7aa46e4e))
- **test:** flaky converter performance test in CI ([8f43f0e](https://github.com/FortAwesome/react-fontawesome/commit/8f43f0eb9a1e853417c9bf901adf7a2c7c372f60))
- **WCAG:** correctly read aria-label and ensure aria-hidden is false when label present ([19ddeb3](https://github.com/FortAwesome/react-fontawesome/commit/19ddeb337e0b3630e8a933e77b5327888c13314d))

###### Testing

- **converter:** fix unit test for aria-label handling ([8c49cdc](https://github.com/FortAwesome/react-fontawesome/commit/8c49cdc477eadfbe32a406a069ebdea3da303381))
- remove flaky test ([f9605ab](https://github.com/FortAwesome/react-fontawesome/commit/f9605ab25a402d1da0787eaa96a22bebd9f164a4))
- remove unnecessary test conditionals for v5 ([fd5bf9b](https://github.com/FortAwesome/react-fontawesome/commit/fd5bf9b025c7ba5cbff7da66221ae9e8487499cd))

###### Chores

- don't include release notes in release commit ([78ce3f8](https://github.com/FortAwesome/react-fontawesome/commit/78ce3f82df9dab290687a2413def844bdf0c88f6))
- **dx:** integrate semantic-release and commitlint ([de5b958](https://github.com/FortAwesome/react-fontawesome/commit/de5b958305654076b41f8328fed03ec009015921))
- remove dependency on semver ([066019b](https://github.com/FortAwesome/react-fontawesome/commit/066019b30f4983be7189267dd75499f265294759))
- update release config for better changelogs ([7d2c242](https://github.com/FortAwesome/react-fontawesome/commit/7d2c242ff4dc66e33a2d3c2694ed45da479d2b90))

###### CI/CD

- **actions:** refactor CI workflow to split some jobs out of matrix ([d0d1fb6](https://github.com/FortAwesome/react-fontawesome/commit/d0d1fb61bc571cb3d476fec57d7b66a4508a1938))
- **actions:** use commitlint github action ([4ab8726](https://github.com/FortAwesome/react-fontawesome/commit/4ab8726ca91799c95cadb2f95334e8a66049c4c6))
- use public npm registry for npm ci ([69ea57b](https://github.com/FortAwesome/react-fontawesome/commit/69ea57b6b411e74ce027612959c113ff3404886e))

### v3.0.1 — Release 3.0.1

- Date: 2025-08-27
- Version: v3.0.1
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/v3.0.1
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/v3.0.1

- **fixed** — Refactored SVGCore version checks to use dynamic import to fix issue #589
- **changed** — Added additional module resolution configs in package.json

##### Bug Fixes
- Added additional module resolution configs in `package.json` (b078d99)
- Refactored SVGCore version checks to use dynamic import to fix #589 (bc7cad0)

**Full Changelog**: https://github.com/FortAwesome/react-fontawesome/compare/3.0.0...3.0.1

### 3.0.0 — Release 3.0.0

- Date: 2025-08-22
- Version: 3.0.0
- Original notes: https://github.com/FortAwesome/react-fontawesome/releases/tag/3.0.0
- Permalink: https://whatsnew.fyi/product/react-fontawesome/releases/3.0.0

- **removed** — Support for FontAwesome versions below v6
- **removed** — Support for Node versions below 20.x
- **removed** — Support for React versions below 18.x
- **removed** — Support for browser versions that do not support the ES2020 standard, specifically JavaScript built-in globalThis
- **changed** — Rewrote the entire library from plain JavaScript to TypeScript
- **changed** — Replaced rollup with tsup for providing both ESM and CJS exports from one TypeScript source
- **removed** — prop-types dependency in favour of colocated typings for React component props
- **added** — Better type definitions to each prop including examples of usage
- **changed** — Upgraded eslint from v6 to v9 with Flat Config and modernised ESLint config, plugins and rules
- **changed** — Refactored all unit tests from react-test-renderer to @testing-library/react
- **changed** — Upgraded all development dependencies to latest versions
- **fixed** — Accessibility ID generation (titleId, maskId) for SSR ensuring consistent ID across server and client renders
- **fixed** — TypeScript errors when styling duotone icons with CSS variables
- **fixed** — aria-hidden attribute to be false if there is a non-empty aria-label attribute
- **fixed** — Large number of npm audit issues by removing and updating dependencies
- **changed** — Optimised FontAwesomeIcon by reducing per-render function calls and memory allocations
- **changed** — Optimised classList function by removing runtime semver checks and array operations
- **changed** — Optimised converter with a full rewrite for significant performance increases of approximately 70%
- **changed** — Moved inline class strings from getClassListFromProps to pre-computed maps

##### BREAKING

- Dropped support for end-of-life FontAwesome versions (below v6), Node versions (below 20.x) and React versions (below 18.x)
- Dropped support for browser versions that don't support the ES2020 standard, namely [JavaScript built-in: globalThis](https://caniuse.com/mdn-javascript_builtins_globalthis)

##### Changes

- Rewrote the entire library from plain JavaScript to TypeScript
- Replaced `rollup` with `tsup` for providing both ESM and CJS exports from one TypeScript source
- Removed `prop-types` in favour of colocated typings for React component props
- Added better type definitions to each prop including examples of usage
- Upgraded `eslint` from v6 to v9, rewrote config as Flat Config, modernised ESLint config, plugins and rules
- Refactored all unit tests from the deprecated `react-test-renderer` to the industry standard `@testing-library/react`
- Upgraded all other development dependencies to latest versions as of release date
- Optimised `FontAwesomeIcon` by reducing per-render function calls and memory allocations
- Optimised `classList` function by removing runtime semver checks and array operations
- Optimised `converter` with a full rewrite for significant performance increases (~70%)
- Moved inline class strings from `getClassListFromProps` to pre-computed maps

##### Bug Fixes

- Fixed accessibility ID generation (`titleId, maskId`) for SSR ensuring a consistent ID across server and client renders (#93, #550, #573)
- Fixed TypeScript errors when styling duotone icons with CSS variables (#509)
- Fixed `aria-hidden` so it is `false` if there is a non-empty `aria-label` attribute (#126)
- Resolved large number of `npm audit` issues by removing and updating dependencies

##### New Contributors
* @charles4221 made their first contribution in https://github.com/FortAwesome/react-fontawesome/pull/581

**Full Changelog**: https://github.com/FortAwesome/react-fontawesome/compare/0.2.6...3.0.0