Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

Ionicons

by Ionic

An open-source icon set from Ionic, distributed under the MIT License.

Icons Code libraryOpen source

GitHub repoWebsite
A settings screen with outline icons and a bottom tab bar, six icons in filled, outline and sharp, and one outline heart at line widths 16, 32 and 48 px.
Made by AgentGid with ionicons 8.1.0 (npm), the ion-icon web component served from the unpacked package. MIT license, which allows showing and passing on the icons; no brand logo icons are used.

2. Commercial use: LICENSE on GitHub

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software”

MIT; use them wherever you see fit, personal or commercial.

LICENSE on GitHub

License checked Nov 9, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

Ionicons: app icons in filled, outline and sharp

Ionicons is a free icon set from the team behind the Ionic app toolkit, made for websites and for apps on iPhone, Android and desktop. Most icons come in three looks: filled, outline and sharp. You add an icon to a page with one short tag and its name, and you may use it in paid products.

Where you can use it

Tab bars and menus in mobile-style apps

Give the bottom tabs and menu rows of an app a familiar look, such as home, explore, chats and settings, on the web or in a phone app.

Filled and outline states

Show an outline heart or bookmark, and the filled one once the user taps it; a sharp version gives a more angular look.

iPhone look and Android look

In an app built with Ionic, show the outline icon on iPhone and the sharp one on Android, so each feels at home.

Host only the icons you use

Serve the icon files from your own site and register just the few icons you need, instead of loading them from an outside server.

Your own icons next to theirs

Show your own logo or a custom drawing with the same tag, so it sizes and colors like the built-in icons.

Settings screens in web apps Idea

Put an outline icon in front of each settings row, like notifications, dark mode, language and billing, for a calm, tidy list.

As reported by Ionic: about 1,300 icons for web, iOS, Android and desktop apps.

Ionicons popularity

44 / 100
Gid Score, same scale as developer tools
18,253
GitHub stars
890.3K
npm downloads, last 7 days
+0.2% in 4 weeks
1
AI-agent projects using it, from our repo scan of 4,817
Ionicons: downloads per weeknpm, ionicons 890,276
Ionicons: GitHub starsionic-team/ionicons 18,253

Downloads from api.npmjs.org, stars from GitHub, checked Nov 17, 2026. How the Gid Score is calculated

How to start

Tell your AI assistant

“Add Ionicons 8.1.0 (pinned, not latest) and use outline icons in the settings rows and tab bar, the filled version for the active tab, aria-hidden on decorative icons and an aria-label on icon-only buttons.”

Show codeStep 1 or Step 2 or Step 3

In an Ionic app there is nothing to install. Elsewhere, add the script near the end of the page, with a fixed version instead of latest.

<script type="module" src="https://unpkg.com/ionicons@8.1.0/dist/ionicons/ionicons.esm.js"></script>

Mistakes to avoid

Copying the script tag from ionic.io/ionicons/usage, which reads https://unpkg.com/ionicons@undefined/dist/ionicons/ionicons.esm.js
<script type="module" src="https://unpkg.com/ionicons@8.1.0/dist/ionicons/ionicons.esm.js"></script>

On 2026-11-09 the usage page printed "undefined" where the version belongs, so the copied address points to no release.

<script type="module" src="https://esm.sh/ionicons@latest/loader"></script> in production
A fixed version, e.g. the 8.1.0 file above, or the npm package with setAssetPath

latest changes under you. Also, in the 8.1.0 package the loader file only exports defineCustomElements, while dist/ionicons/ionicons.esm.js (used in our demo) starts the icons by itself.

<ion-icon name="logo-github-outline">
<ion-icon name="logo-github">

Logo icons have no outline or sharp version.

<button><ion-icon name="heart"></ion-icon></button> with no label
<button aria-label="Favorite"><ion-icon name="heart" aria-hidden="true"></ion-icon></button>

Interactive icons need alternate text, and decorative ones should be hidden from screen readers.

Setting --ionicon-stroke-width on a filled icon like name="heart"
Use the outline variant (heart-outline) when you want a thinner or thicker line

Only outline icons have a line width to change.

License

MIT License. Free for personal and paid products, and you may share the files if the short license notice goes with them. Brand logo icons stay the trademarks of their owners.

Commercial use
Yes

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” LICENSE on GitHub

Credit
Not needed

“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” LICENSE on GitHub

Inside your app or game
Can ship inside your app

“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files” LICENSE on GitHub

Pass the files on to your users
Allowed

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” LICENSE on GitHub

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is Ionicons free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with Ionicons. Paste them into your prompt or AGENTS.md.

License rules
- Ionicons (Icons). An open-source icon set from Ionic, distributed under the MIT License. Price: free; commercial use OK; no credit needed.
  Connect: npm ionicons.
  Get files: npm install ionicons, or load the ionicons web component from a CDN with a pinned version (the official usage page prints ionicons@undefined) and use <ion-icon name="heart"></ion-icon> (svg).
  Rule: Keep the MIT license file and copyright notice with any copies of the icons you ship.
  Rule: Do not remove the Ionic copyright notice from distributed files.
  License: https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/ionicons/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install ionicons
How an agent gets files
npm install ionicons, or load the ionicons web component from a CDN with a pinned version (the official usage page prints ionicons@undefined) and use <ion-icon name="heart"></ion-icon>.

Formats: svg

API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Icons: Ionicons by Ionic (MIT)
This card for machines

Alternatives

Ionicons This page

Free Commercial OK npm

Material Symbols

Pick Material Symbols for Google's own Android look, served as one adjustable icon font.

Free Commercial OK MCP

Lucide

Pick Lucide for a larger set of line icons with ready packages for React, Vue, Svelte and Angular.

Free Commercial OK npm

Tabler Icons

Pick Tabler Icons for a much larger MIT set with outline and filled versions.

Free Commercial OK npm

Material Design Icons (Pictogrammers)

Community Material Design icon set (7,000+ icons, as reported) as SVG, webfont and JS packages (@mdi/js, @mdi/font).

Free Commercial OK npm

Carbon Icons

IBM Carbon Design System icon set and pictograms as SVG and React/Vue packages.

Free Commercial OK npm

All icons

Questions

Can I use Ionicons in a paid app?

Yes. The icons are MIT licensed and free for personal or commercial use; keep the license notice with copies of the files.

Do I need the Ionic toolkit?

No. Ionic apps include Ionicons already; any other web page can load the ion-icon component with one script tag.

How do I get the outline or sharp version?

Add -outline or -sharp to the icon name, like heart-outline; the plain name is the filled one. Logo icons have only one version.

Can I use my own SVG file with it?

Yes, pass its address in src. The file must be a valid SVG without scripts or events.

Can I use brand logos like social networks?

They are in the set, but they remain trademarks of their owners and do not mean the owner endorses you; follow each brand's rules.