Changelog

Version history and release notes for React Icons

Changelog

Track updates, new features, and changes in React Icons.

Current Version

The current version is 5.6.0. Always check the GitHub releases for the latest updates.

How to Update

Update to the latest version:

npm

npm install react-icons@latest

Version History

Version 5.x

v5.6.0 (Current)

Icon Library Updates:

• Updated Font Awesome 6 to 6.7.2 (2,060 icons)
• Updated Lucide to 0.462.0 (1,541 icons)
• Updated Bootstrap Icons to 1.13.1 (2,754 icons)
• Updated Remix Icon to 4.6.0 (3,058 icons)
• Updated Tabler Icons to 3.35.0 (5,963 icons)
• Updated Simple Icons to 15.16.0 (3,364 icons)
• Updated Material Design to latest commit (4,341 icons)
• Updated Grommet Icons to 4.14.0 (637 icons)
• Updated Heroicons 2 to 2.2.0 (972 icons)
• Updated VS Code Icons to 0.0.40 (498 icons)
• Updated Radix Icons (332 icons)

Package Updates:

• TypeScript 5.9.2
• Babel 7.28+
• ESBuild 0.25.10
• Updated build tooling

Total: 40,000+ icons from 30+ icon packs

v5.5.0

Changes:

• Icon library updates
• Dependency updates
• Bug fixes

v5.0.0

Major Updates:

• Multiple icon library updates to latest versions
• Improved TypeScript definitions
• Performance optimizations
• Build process improvements

Migration: Generally backward compatible with v4. See Migration Guide.

Version 4.x

v4.12.0

Changes:

• Icon library updates
• Added new icon packs
• TypeScript improvements
• Performance enhancements

v4.0.0

Major Release:

• Support for 30+ icon libraries
• Improved tree-shaking
• Enhanced TypeScript support
• Better bundle size optimization

Version 3.x

v3.11.0

Changes:

• Icon library updates
• Bug fixes
• Documentation improvements

v3.0.0

Breaking Changes:

• New import syntax (ES6 named imports)
• Removed automatic vertical-align: middle
• Native TypeScript support (removed need for @types/react-icons)

Migration: See Migration Guide v2 to v3

New Features:

• ES6 module support with tree-shaking
• Significantly smaller bundle sizes
• Better TypeScript integration

Version 2.x (Legacy)

v2.2.7

Last v2 Release:

• Default imports from individual files
• Automatic vertical alignment
• External TypeScript definitions

Note: v2 is no longer maintained. Upgrade to v5 for the latest features and bug fixes.

Icon Library Versions

Current versions of included icon libraries (v5.6.0):

Icon Library	Version	Icon Count
Circum Icons	1.0.0	288
Font Awesome 5	5.15.4	1,612
Font Awesome 6	6.7.2	2,060
Ionicons 4	4.6.3	696
Ionicons 5	5.5.4	1,332
Material Design	4.0.0	4,341
Typicons	2.1.2	336
GitHub Octicons	18.3.0	264
Feather	4.29.2	287
Lucide	0.462.0	1,541
Game Icons	-	4,040
Weather Icons	2.0.12	219
Devicons	1.8.0	192
Ant Design	4.4.2	831
Bootstrap Icons	1.13.1	2,754
Remix Icon	4.6.0	3,058
Flat Color Icons	1.0.2	329
Grommet Icons	4.14.0	637
Heroicons	1.0.6	460
Heroicons 2	2.2.0	972
Simple Icons	15.16.0	3,364
Simple Line Icons	2.5.5	189
IcoMoon Free	-	491
BoxIcons	2.1.4	1,634
css.gg	2.1.4	704
VS Code Icons	0.0.40	498
Tabler Icons	3.35.0	5,963
Themify Icons	v0.1.2	352
Radix Icons	1.3.2	332
Phosphor Icons	2.1.1	9,072
Icons8 Line Awesome	1.3.1	1,544

See the VERSIONS file for the most up-to-date version information.

Deprecations

@react-icons/all-files

The @react-icons/all-files package is deprecated and no longer maintained. Use the main react-icons package instead, which provides better tree-shaking support.

# ❌ Deprecated
npm install @react-icons/all-files

# ✅ Recommended
npm install react-icons

Old Import Syntax (v2)

The v2 import syntax is no longer supported in v3+:

// ❌ Old (v2)
import FaBeer from "react-icons/lib/fa/beer";

// ✅ New (v3+)
import { FaBeer } from "react-icons/fa";

Release Schedule

React Icons doesn’t follow a fixed release schedule. Updates are published as needed when:

• Icon libraries release new versions
• Bug fixes are completed
• New features are added
• Security updates are required

Staying Updated

GitHub Releases

Subscribe to release notifications

GitHub Watch

Watch the repository for updates

npm Package

Check package versions on npm

Changelog RSS

Subscribe to release feed

Contributing

Help keep React Icons up to date:

1. Report outdated icons

   Open an issue if an icon library has a newer version available.

2. Submit updates

   Follow the Contributing guide to update icon packs.

3. Propose new libraries

   Start a discussion to propose new icon packs.

Version Support

Version	Status	Support
5.x	✅ Active	Full support, receives updates
4.x	⚠️ Maintenance	Security fixes only
3.x	⚠️ Maintenance	Security fixes only
2.x	❌ End of Life	No longer supported

We recommend upgrading to the latest version (5.x) to receive new icons, bug fixes, and performance improvements.

Semantic Versioning

React Icons follows Semantic Versioning:

• Major (X.0.0): Breaking changes, API changes
• Minor (5.X.0): New features, icon library additions, backward compatible
• Patch (5.6.X): Bug fixes, icon library updates, backward compatible

Next Steps

Migration Guides

Upgrade from older versions

Release Notes

Read detailed release notes on GitHub