# Ionicons — card for AI agents

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

Category: Icons · maker Ionic · checked 2026-11-09

## Price
- Price: Free
- Free tier: Free open-source use under the MIT License

## License
MIT License — https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE

- commercial: **yes** (Commercial use OK)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE)
- in app: **yes** (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
  (https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE)

## Rules to follow
- Keep the MIT license file and copyright notice with any copies of the icons you ship.
- Do not remove the Ionic copyright notice from distributed files.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## 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

## How to connect
- Package (npm/PyPI)
- npm: `npm install ionicons`
- Repository: https://github.com/ionic-team/ionicons
- Website: https://ionic.io/ionicons

## Notes
Added automatically: used in 1 public AI-built projects we sampled. License read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 44
- GitHub stars: 18,253
- Downloads last week: 890,276
- Used in 1 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- 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/)
```

## Links
- AgentGid page: https://agentgid.com/assets/ionicons/
- Is it free for commercial use? https://agentgid.com/assets/ionicons/commercial-use/
- Source: https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE


## 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 to 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: Put an outline icon in front of each settings row, like notifications, dark mode, language and billing, for a calm, tidy list. (idea, not from the official pages)

### How to start
- 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>
```

- Place an icon by name; add -outline or -sharp to the name for the other looks.

```
<ion-icon name="heart"></ion-icon>
```

- Set size and color with ordinary styles; the docs suggest sizes in steps of 8 pixels.

```
ion-icon {
  font-size: 64px;
}
```


### 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.

### Good to know
- Brand logos in the set belong to their companies; showing one does not mean the company supports your product.
- Logo icons have only one look; the outline and sharp versions exist only for the regular app icons.
- The icon tag fetches each icon file when it becomes visible, so icons further down the page load only when needed.
- Older browsers are left out: it needs Chrome 79, Safari 14, Edge 79 or Firefox 70 or newer, and Internet Explorer 11 is not supported.
- Only outline icons let you change the line thickness; the default is 32 on the icon's own scale.

Checked 2026-11-09 against: https://ionic.io/ionicons, https://ionic.io/ionicons/usage, https://github.com/ionic-team/ionicons/blob/main/readme.md, https://github.com/ionic-team/ionicons/blob/main/LICENSE, https://registry.npmjs.org/ionicons/latest, https://registry.npmjs.org/ionicons/8.1.0, https://api.github.com/repos/ionic-team/ionicons

### Mistakes to avoid
- Don't: Copying the script tag from ionic.io/ionicons/usage, which reads https://unpkg.com/ionicons@undefined/dist/ionicons/ionicons.esm.js → Do: <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.)
- Don't: <script type="module" src="https://esm.sh/ionicons@latest/loader"></script> in production → Do: 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.)
- Don't: <ion-icon name="logo-github-outline"> → Do: <ion-icon name="logo-github"> (Logo icons have no outline or sharp version.)
- Don't: <button><ion-icon name="heart"></ion-icon></button> with no label → Do: <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.)
- Don't: Setting --ionicon-stroke-width on a filled icon like name="heart" → Do: Use the outline variant (heart-outline) when you want a thinner or thicker line (Only outline icons have a line width to change.)

### 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
