@heroicons/react
2.2.0 · 18 Nov 2024MIT6.8M / weekRepositoryHomepagenpmAtom feed
34 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 2.x · latest line
2.2.0
18 Nov 2024Add React 19 support
Removed unnecessary clipping path from
solid/arrow-left-circle
2.1.5
10 Jul 2024Add new icons (
arrow-turn-*,bold,calendar-date-range,divide,document-currency-*,equals,h1,h2,h3,italic,link-slash,numbered-list,percent-badge,slash,strikethrough,underline)
2.1.4
17 Jun 2024Improve tree-shakability of React package
2.1.3
22 Mar 2024Improve project READMEs
2.1.2
22 Mar 2024Include license file with published packages
2.1.1
18 Dec 2023Fixed chevrons in mini set
2.1.0
18 Dec 2023- Deprecated
Renamed
arrow-left-on-rectangletoarrow-left-end-on-rectangle - Deprecated
Renamed
arrow-right-on-rectangletoarrow-right-start-on-rectangle - Deprecated
All
*-smallicons in the outline and solid sets, use mini set instead
Heroicons Micro
We just released Heroicons v2.1 which includes a brand new micro style — a full set of almost three hundred 16×16 icons designed for tighter, higher density UIs.
Learn more about the new set in the announcement post →
Added
Added full set of 16×16 micro icons
Added
arrow-left-start-on-rectangleandarrow-right-end-on-rectangleicons to all sets
Changes
Minor improvements to the
receipt-percent,receipt-refund,speaker-wave,speaker-x-mark,tag,ticket,window,video-camera-slash,plus, andminusicons in the mini setMinor improvements to
chevron-down,chevron-left,chevron-right,chevron-up, andchevron-up-downicons in all sets
Deprecations
- Deprecated
Renamed
arrow-left-on-rectangletoarrow-left-end-on-rectangle - Deprecated
Renamed
arrow-right-on-rectangletoarrow-right-start-on-rectangle - Deprecated
All
*-smallicons in the outline and solid sets, use mini set instead - Deprecated
All
*-smallicons in the mini set, use micro set instead
2.0.18
9 May 2023Fix incorrect
esmpaths in package.json for both React and Vue
2.0.17
30 Mar 2023Fix React icon types
2.0.16
17 Feb 2023Add root-level import
2.0.15
8 Feb 2023Fix icon tree-shaking
2.0.14
25 Jan 2023Fix React ref types
Specify explicit package exports
2.0.13
2 Nov 2022Fix
minusicon alignment
2.0.12
5 Oct 2022Add
titleandtitleIdprops to the React typesFix
information-circleicon alignment
2.0.11
12 Sep 2022Add new icons (
bug-ant,eye-dropper,pause-circle,play-circle,power,rocket-launch,square-2-stack-3d,stop-circle,trophy,tv,viewfinder-circle,window)
2.0.10
30 Aug 2022Fix
arrow-pathdirection and fix optical alignment ofexclamation-triangle
2.0.9
30 Aug 2022Allow setting title via prop
Add new icons (
arrow-small-down,arrow-small-left,arrow-small-right,arrow-small-up,battery-0,battery-100,battery-50,cube-transparent,currency-bangladeshi,minus-small,paint-brush,plus-small,variable,wallet,arrow-path-rounded-square) and fix optical alignment and appearance of icons (bookmark-slash,bookmark,exclamation-triangle,table-cells,view-columns,arrow-path)
2.0.8
26 Aug 2022Fix optical alignment and size of icons (
heart,minus,pencil-square,user-plus,x-mark,hand-thumb-up,hand-thumb-down)Fix size of icons (
arrow-down-left,arrow-down-right,arrow-down,arrow-left,arrow-right,arrow-up-left,arrow-up-right,arrow-up)Fix optical alignment and size of
tagicon
Fixed
Fix optical alignment and size of icons (
heart,minus,pencil-square,user-plus,x-mark,hand-thumb-up,hand-thumb-down)Fix size of icons (
arrow-down-left,arrow-down-right,arrow-down,arrow-left,arrow-right,arrow-up-left,arrow-up-right,arrow-up)Fix optical alignment and size of
tagiconFix size of
checkicon
Added
Add
user-minusicon
2.0.7
25 Aug 2022Improve optical alignment and sizing of icons (
hand-thumb-up,hand-thumb-down,plus,minus)
2.0.6
25 Aug 2022Fix size of icons (
chevron-double-down,chevron-double-left,chevron-double-right,chevron-double-up,chevron-down,chevron-left,chevron-right,chevron-up,funnel,minus,plus)
2.0.5
25 Aug 2022Modify the curved design of the
check-*icons to a straight check
2.0.4
24 Aug 2022- Removed
Remove additional stroke from outline icons (
bars-arrow-down,bars-arrow-up,chevron-up-down,rss)
2.0.3
24 Aug 2022Add missing icons from v1 (
bars-arrow-down,bars-arrow-up,chevron-up-down,rss)Fix inconsistent naming for 'code-bracket' icons
2.0.2
24 Aug 2022Maintenance only: docs, tests, build or refactoring. Nothing changes in how you use it.
2.0.1
23 Aug 2022Warn when trying to import from v1 paths
2.0.0
23 Aug 2022Outline — line icons with a 1.5px stroke, drawn in a 24px view box.
Solid — solid icons with filled shapes, drawn in a 24px view box.
Mini — solid icons with filled shapes, drawn in a 20px view box.
Heroicons v2.0
We just released Heroicons v2.0 — a brand new icon set, illustrated from scratch, that includes icons in three distinct styles.
Outline — line icons with a 1.5px stroke, drawn in a 24px view box.
Solid — solid icons with filled shapes, drawn in a 24px view box.
Mini — solid icons with filled shapes, drawn in a 20px view box.
Check out all of the new icons on the redesigned Heroicons v2.0 website.
Upgrading from v1
Heroicons v2.0 is a brand new icon set with a different visual style, so don't feel like you need to upgrade to avoid "being on the old version".
If you like how the v1 icons look in your project, stick with them! Heroicons v2 is more like Terminator 2 than OpenSSL 2 — they represent our best work but these are just little SVG pictures, the version you choose to use is personal preference, not a technical decision.
If you do want to upgrade to v2, understand that because it's an all-new icon set, switching to Heroicons v2 is more like migrating to a new icon set than it is just updating a dependency in your project. We've tried to make it pretty smooth, but because it's a new set, a lot things like import paths and icon names have changed, so there is some manual work involved in migrating.
Update dependencies
Install the latest version of the package you're using via npm:
# Using React npm install @heroicons/react@latest # Using Vue npm install @heroicons/vue@latest
Update imports
Since Heroicons v2.0 comes with a new third style, we've updated the import paths for all of the icons to make them more explicit and future-proof.
# Using React - import { ... } from '@heroicons/react/solid' + import { ... } from '@heroicons/react/20/solid' - import { ... } from '@heroicons/react/outline' + import { ... } from '@heroicons/react/24/outline' # Using Vue - import { ... } from '@heroicons/vue/solid' + import { ... } from '@heroicons/vue/20/solid' - import { ... } from '@heroicons/vue/outline' + import { ... } from '@heroicons/vue/24/outline'Update icon names
Many of the icons have been renamed to more literal names that describe what the icon is, instead of describing what the icon should be used for. For example,
mailhas been renamed toenvelope, andsearchhas been renamed tomagnifying-glass.Here is a list of all of the icons that have been renamed along with their updated names:
v1.0.6 v2.0.10 adjustmentsadjustments-verticalannotationchat-bubble-bottom-center-textarchivearchive-boxarrow-circle-downarrow-down-circlearrow-circle-leftarrow-left-circlearrow-circle-rightarrow-right-circlearrow-circle-uparrow-up-circlearrow-narrow-downarrow-long-downarrow-narrow-leftarrow-long-leftarrow-narrow-rightarrow-long-rightarrow-narrow-uparrow-long-uparrow-sm-leftarrow-small-leftarrow-sm-rightarrow-small-rightarrow-sm-uparrow-small-uparrow-sm-downarrow-small-downarrows-expandarrows-pointing-outbadge-checkcheck-badgebanno-symbolbookmark-altbookmark-squarecashbanknoteschart-square-barchart-bar-squarechat-alt-2chat-bubble-left-rightchat-altchat-bubble-left-ellipsischatchat-bubble-oval-left-ellipsischipcpu-chipclipboard-checkclipboard-document-checkclipboard-copyclipboard-documentclipboard-listclipboard-document-listcloud-downloadcloud-arrow-downcloud-uploadcloud-arrow-upcodecode-bracketcollectionrectangle-stackcolor-swatchswatchcursor-clickcursor-arrow-raysdatabasecircle-stackdesktop-computercomputer-desktopdevice-mobiledevice-phone-mobiledocument-adddocument-plusdocument-downloaddocument-arrow-downdocument-removedocument-minusdocument-reportdocument-chart-bardocument-searchdocument-magnifying-glassdots-circle-horizontalellipsis-horizontal-circledots-horizontalellipsis-horizontaldots-verticalellipsis-verticaldownloadarrow-down-trayduplicatesquare-2-stackemoji-happyface-smileemoji-sadface-frownexternal-linkarrow-top-right-on-squareexclamationexclamation-triangleeye-offeye-slashfast-forwardforwardfilterfunnelfolder-addfolder-plusfolder-downloadfolder-arrow-downfolder-removefolder-minusglobeglobe-americashandhand-raisedinbox-ininbox-arrow-downlibrarybuilding-librarylightning-boltboltlocation-markermap-pinloginarrow-left-on-rectanglelogoutarrow-right-on-rectanglemail-openenvelope-openmailenvelopemenu-alt-1bars-3-center-leftmenu-alt-2bars-3-bottom-leftmenu-alt-3bars-3-bottom-rightmenu-alt-4bars-2menubars-3minus-smminus-smallmusic-notemusical-noteoffice-buildingbuilding-officepencil-altpencil-squarephone-incomingphone-arrow-down-leftphone-missed-callphone-x-markphone-outgoingphone-arrow-up-rightphotographphotoplus-smplus-smallpuzzlepuzzle-pieceqrcodeqr-codereceipt-taxreceipt-percentrefresharrow-pathreplyarrow-uturn-leftrewindbackwardsave-asarrow-down-on-square-stacksavearrow-down-on-squaresearch-circlemagnifying-glass-circlesearchmagnifying-glassselectorchevron-up-downsort-ascendingbars-arrow-upsort-descendingbars-arrow-downspeakerphonemegaphonestatus-offlinesignal-slashstatus-onlinesignalsupportlifebuoyswitch-horizontalarrows-right-leftswitch-verticalarrows-up-downtabletable-cellstemplaterectangle-groupterminalcommand-linethumb-downhand-thumb-downthumb-uphand-thumb-uptranslatelanguagetrending-downarrow-trending-downtrending-uparrow-trending-upuploadarrow-up-trayuser-adduser-plususer-removeuser-minusview-boardsview-columnsview-grid-addsquares-plusview-gridsquares-2x2view-listbars-4volume-offspeaker-x-markvolume-upspeaker-wavexx-markzoom-inmagnifying-glass-pluszoom-outmagnifying-glass-minus- 1.x
1.0.6
2 Mar 2022Add
forwardRefsupport for React componentsAdd
sideEffectstopackage.jsonfilesFix folder icons
Added
Add
forwardRefsupport for React components
Fixed
Add
sideEffectstopackage.jsonfilesFix folder icons
Fix Vue TypeScript declarations
Move
stroke-widthfrompathtosvg
1.0.5
22 Oct 2021Add MIT license to
package.jsonfilesAdd
aria-hidden="true"attributeFix solid
arrows-expandfill color
Fixed
Add MIT license to
package.jsonfilesAdd
aria-hidden="true"attributeFix solid
arrows-expandfill colorAdd
{"type": "module"}toesmpackage.jsonfiles
1.0.4
17 Aug 2021Fix Vue type declarations
1.0.3
26 Jul 2021Add Vue type declarations
1.0.2
9 Jul 2021Add correct
plusicons
1.0.1
14 Apr 2021Add small arrow icons (
arrow-sm-up,arrow-sm-right,arrow-sm-down,arrow-sm-left)
1.0.0
29 Mar 2021- 0.1.x
0.1.0
26 Jan 2021
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.