unstale

npm / ionicons

ionicons

What changed in ionicons 5 to 8, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-27.

6 breaking5 new APIs and options4 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.8 on npm

ionicons 87 changes

New APIs and options 4

Fixes and other changes 3

ionicons 71 changes

Breaking changes 1

  • 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.0release notes

ionicons 62 changes

Breaking changes 2

  • The ariaHidden property was removed; use the aria-hidden attribute instead.

    6.0.0release notes

  • The ariaLabel property was removed; use the aria-label attribute instead.

    6.0.0release notes

ionicons 55 changes

Breaking changes 3

  • Icons now have filled, outline, and sharp appearance variants, selected by suffixes such as -outline and -sharp.

    5.0.0release notes

  • Some icon names were removed or renamed. Update usages to the replacement names listed in the breaking-changes table.

    5.0.0release notes

  • 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.0release notes

New APIs and options 1

  • CSS can adjust the stroke weight of icons that use the outline variant.

    5.0.0release notes

Fixes and other changes 1

  • Every icon was redrawn to better match the latest iOS and Material platform styles.

    5.0.0release notes