> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/react-icons/react-icons/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Version history and release notes for React Icons

# Changelog

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

## Current Version

<Note>
  The current version is **5.6.0**. Always check the [GitHub releases](https://github.com/react-icons/react-icons/releases) for the latest updates.
</Note>

## How to Update

Update to the latest version:

<CodeGroup>
  ```bash npm theme={null}
  npm install react-icons@latest
  ```

  ```bash yarn theme={null}
  yarn add react-icons@latest
  ```

  ```bash pnpm theme={null}
  pnpm add react-icons@latest
  ```
</CodeGroup>

## Version History

### Version 5.x

<Accordion title="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
</Accordion>

<Accordion title="v5.5.0">
  **Changes:**

  * Icon library updates
  * Dependency updates
  * Bug fixes
</Accordion>

<Accordion title="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](/migration/v4-to-v5).
</Accordion>

### Version 4.x

<Accordion title="v4.12.0">
  **Changes:**

  * Icon library updates
  * Added new icon packs
  * TypeScript improvements
  * Performance enhancements
</Accordion>

<Accordion title="v4.0.0">
  **Major Release:**

  * Support for 30+ icon libraries
  * Improved tree-shaking
  * Enhanced TypeScript support
  * Better bundle size optimization
</Accordion>

### Version 3.x

<Accordion title="v3.11.0">
  **Changes:**

  * Icon library updates
  * Bug fixes
  * Documentation improvements
</Accordion>

<Accordion title="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](/migration/v2-to-v3)

  **New Features:**

  * ES6 module support with tree-shaking
  * Significantly smaller bundle sizes
  * Better TypeScript integration
</Accordion>

### Version 2.x (Legacy)

<Accordion title="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.
</Accordion>

## 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      |

<Info>
  See the [VERSIONS file](https://github.com/react-icons/react-icons/blob/master/packages/react-icons/VERSIONS) for the most up-to-date version information.
</Info>

## Deprecations

### @react-icons/all-files

<Warning>
  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.
</Warning>

```bash theme={null}
# ❌ Deprecated
npm install @react-icons/all-files

# ✅ Recommended
npm install react-icons
```

### Old Import Syntax (v2)

<Warning>
  The v2 import syntax is no longer supported in v3+:
</Warning>

```jsx theme={null}
// ❌ Old (v2)
import FaBeer from "react-icons/lib/fa/beer";

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

## Release Schedule

<Info>
  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
</Info>

## Staying Updated

<CardGroup cols={2}>
  <Card title="GitHub Releases" icon="tag" href="https://github.com/react-icons/react-icons/releases">
    Subscribe to release notifications
  </Card>

  <Card title="GitHub Watch" icon="eye" href="https://github.com/react-icons/react-icons">
    Watch the repository for updates
  </Card>

  <Card title="npm Package" icon="npm" href="https://www.npmjs.com/package/react-icons">
    Check package versions on npm
  </Card>

  <Card title="Changelog RSS" icon="rss" href="https://github.com/react-icons/react-icons/releases.atom">
    Subscribe to release feed
  </Card>
</CardGroup>

## Contributing

Help keep React Icons up to date:

<Steps>
  <Step title="Report outdated icons">
    Open an issue if an icon library has a newer version available.
  </Step>

  <Step title="Submit updates">
    Follow the [Contributing guide](/advanced/contributing) to update icon packs.
  </Step>

  <Step title="Propose new libraries">
    Start a [discussion](https://github.com/react-icons/react-icons/discussions) to propose new icon packs.
  </Step>
</Steps>

## 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            |

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

## Semantic Versioning

React Icons follows [Semantic Versioning](https://semver.org/):

* **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

<CardGroup cols={2}>
  <Card title="Migration Guides" icon="arrow-up-right-dots" href="/migration/v2-to-v3">
    Upgrade from older versions
  </Card>

  <Card title="Release Notes" icon="note" href="https://github.com/react-icons/react-icons/releases">
    Read detailed release notes on GitHub
  </Card>
</CardGroup>