npm / @heroicons/react
@heroicons/react
What changed in @heroicons/react 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-27.
3 breaking1 new APIs and options
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@heroicons/react 24 changes
Breaking changes 3
The React package uses more explicit import paths for icon styles; this path imports the 20px solid style.
The React package uses more explicit import paths for icon styles; this path imports the 24px outline style.
Many icons have new, more literal names, so applications upgrading from v1 may need to update their imports; for example, mail is now envelope and search is now magnifying-glass.
New APIs and options 1
A third icon style is introduced: solid icons with filled shapes, drawn in a 20px view box.