# What changed in ionicons

> 15 changes in ionicons 5 to 8 from its official release notes, upgrade guides and advisories: 6 breaking, 5 new APIs and options. Each one cited. Sources checked 2026-10-27. HTML: https://unstale.sh/npm/ionicons/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## ionicons 8

### New APIs and options

- Added font icon support to ion-icon. (8.1.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.1.0)
- Added the loveseat tag to bed. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)
- Added the sliders and filters tags to option. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)
- Added the contacts tag to people-circle. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)

### Fixes and other changes

- Applied currentColor to icons for better theming. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)
- Added the bell tag to notifications. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)
- Updated the SVG fill path to fix the icon. (8.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v8.0.0)

## ionicons 7

### Breaking changes

- The automatically generated aria-label was removed; developers should provide aria-label or aria-hidden on ion-icon usages to avoid accessibility issues. (7.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v7.0.0)

## ionicons 6

### Breaking changes

- The ariaHidden property was removed; use the aria-hidden attribute instead. (6.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v6.0.0)
- The ariaLabel property was removed; use the aria-label attribute instead. (6.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/v6.0.0)

## ionicons 5

### Breaking changes

- Icons now have filled, outline, and sharp appearance variants, selected by suffixes such as -outline and -sharp. (5.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0)
- Some icon names were removed or renamed. Update usages to the replacement names listed in the breaking-changes table. (5.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0)
- Ionicons no longer automatically switches icon styles by platform in Ionic Framework apps; use the ios and md attributes to specify platform-specific icon names. (5.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0)

### New APIs and options

- CSS can adjust the stroke weight of icons that use the outline variant. (5.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0)

### Fixes and other changes

- Every icon was redrawn to better match the latest iOS and Material platform styles. (5.0.0) — [release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0)
