HeroIcons for React.
1,288 free icons by Refactoring UI Inc, MIT. Search by name or meaning, then open an icon to copy it as SVG or React, or install it.
HeroIcons
Or describe it. With Pro, your AI agent picks the icon you describe from HeroIcons and installs it as a React component.
Get ProLibraries
Other popular libraries
The sets shadcn/ui projects reach for first, each with its license.
Pricing
HeroIcons MCP, with Pro
Your agent searches all 1,288 HeroIcons and installs the one you describe. The MCP comes with every Pro plan, with 6,000+ blocks and 14 premium templates.
4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.
- Secure checkout via Stripe
- Code lives in your repo
- Keep what you've shipped if you cancel
- License terms
FAQ
Frequently asked questions
About HeroIcons: how many there are, how to use them, and their license.
HeroIcons has 1,288 icons by Refactoring UI Inc, drawn on a 24 × 24 grid. Many come in 2 styles: Default, Solid; pick one above the grid.
Refactoring UI Inc made HeroIcons, released under MIT.
HeroIcons draws many icons in 2 styles: Default, Solid. Pick one above the grid to see only that style, or All to see every drawing.
HeroIcons is in the UI icons group on the libraries page. Sets like it are Lucide, Material Symbols and Tabler Icons. Open each to compare the grid, the style and the license before you pick one.
Search by name or by what an icon shows: each one is tagged with words like "money" or "navigation", so you find it without knowing its exact name. Search runs inside HeroIcons, over its 1,288 icons.
Every HeroIcons icon's page has an Other libraries section with the same icon drawn by other sets, and its tags link to every library that draws the same subject. Use them to compare HeroIcons with the rest.
Open an icon, then copy it as a typed React component or as SVG for any framework or design tool. Signed in, you can also install it with one shadcn CLI command.
Open a HeroIcons icon, then Get icon, and copy it as React, Vue, Svelte, Angular, Solid, Preact, SVG, or as a data URL. Each is one self-contained component or file with the SVG inside.
Open the icon's page, choose Get icon, then Install with shadcn CLI. The CLI adds one file, components/icons/<icon>.tsx, with a size prop and every SVG prop; its first line names HeroIcons, Refactoring UI Inc and MIT. It needs a free account.
You can do either. HeroIcons ships @heroicons/react, which installs the whole set and lets you import the icons you use. Copying a HeroIcons icon from here adds one file and no dependency, and the file is yours to edit.
Yes. Open an icon and pick a color or a stroke width: the preview, the code and the PNG all use it.
HeroIcons is drawn on a 24 × 24 grid, so at the same size it looks as large as its grid allows. Set width and height on the component, or a class like size-6; Customize also sets the size it exports at, plus padding and rotation.
Tailwind text classes: text-primary or text-muted-foreground colors an icon, size-5 sizes it. On an installed icon, className reaches the svg like any prop.
Next to a visible label, a HeroIcons icon is decoration: add aria-hidden="true" so screen readers skip it. Alone, as in an icon-only button, name the button with aria-label instead. The installed component passes every SVG prop through, so both work on it.
HeroIcons icons are drawn in currentColor, so they take the text color and follow your theme in light and dark mode. Icons that carry meaning need 3:1 contrast against their background (WCAG 1.4.11): use the same text color tokens as the label beside them.
Yes. MIT allows commercial use; keep the license notice when you ship the icons' source files. The full terms are in the license, linked on this page.
No visible credit is required: MIT only asks that you keep the license notice if you ship the icons' source files. Icons installed with the shadcn CLI already start with a comment naming HeroIcons, Refactoring UI Inc and the license.
Yes. Every HeroIcons icon is free to browse, copy and download here. Pro adds the MCP server, which installs icons for your AI agent.
With Pro, the shadcn.io MCP server lets Claude Code, Cursor or any MCP client search every library and install the HeroIcons icon you ask for, with search_icons, get_icon and list_icon_libraries.
HeroIcons ships an npm package, @heroicons/react. When your project has it, get_icon answers with the import from that package and adds no file; otherwise it adds a component, one shadcn CLI command for React.
4.9 out of 5 from 150+ developers
Install any HeroIcons icon from a prompt
MCP, 6,000+ blocks and 14 premium templates in every Pro plan. The icons stay free.
Get Pro