{
 "slug": "ionicons",
 "name": "Ionicons",
 "author": "Ionic",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "An open-source icon set from Ionic, distributed under the MIT License.",
 "category": {
  "slug": "icons",
  "name": "Icons"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/ionic-team.png",
 "logo_letter": "I",
 "links": {
  "repo": "https://github.com/ionic-team/ionicons",
  "website": "https://ionic.io/ionicons",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/ionicons/demo.jpg",
  "alt": "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.",
  "caption": "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."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Free open-source use under the MIT License.",
   "source": {
    "label": "ionic.io/ionicons",
    "url": "https://ionic.io/ionicons"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT License",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
   "note": "MIT; use them wherever you see fit, personal or commercial.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install ionicons. No key or account is needed.",
   "source": {
    "label": "github.com/ionic-team/ionicons",
    "url": "https://github.com/ionic-team/ionicons"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT License",
  "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "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."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-09",
  "commercial_use_page": "https://agentgid.com/assets/ionicons/commercial-use/"
 },
 "overview": {
  "heading": "Ionicons: app icons in filled, outline and sharp",
  "body": "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."
 },
 "uses": [
  {
   "title": "Tab bars and menus in mobile-style apps",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Filled and outline states",
   "text": "Show an outline heart or bookmark, and the filled one once the user taps it; a sharp version gives a more angular look.",
   "idea": false,
   "image": null
  },
  {
   "title": "iPhone look and Android look",
   "text": "In an app built with Ionic, show the outline icon on iPhone and the sharp one on Android, so each feels at home.",
   "idea": false,
   "image": null
  },
  {
   "title": "Host only the icons you use",
   "text": "Serve the icon files from your own site and register just the few icons you need, instead of loading them from an outside server.",
   "idea": false,
   "image": null
  },
  {
   "title": "Your own icons next to theirs",
   "text": "Show your own logo or a custom drawing with the same tag, so it sizes and colors like the built-in icons.",
   "idea": false,
   "image": null
  },
  {
   "title": "Settings screens in web apps",
   "text": "Put an outline icon in front of each settings row, like notifications, dark mode, language and billing, for a calm, tidy list.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "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.",
    "source": "<script type=\"module\" src=\"https://unpkg.com/ionicons@8.1.0/dist/ionicons/ionicons.esm.js\"></script>"
   },
   {
    "tab": "Step 2",
    "intro": "Place an icon by name; add -outline or -sharp to the name for the other looks.",
    "source": "<ion-icon name=\"heart\"></ion-icon>"
   },
   {
    "tab": "Step 3",
    "intro": "Set size and color with ordinary styles; the docs suggest sizes in steps of 8 pixels.",
    "source": "ion-icon {\n  font-size: 64px;\n}"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Copying the script tag from ionic.io/ionicons/usage, which reads https://unpkg.com/ionicons@undefined/dist/ionicons/ionicons.esm.js",
   "fix": "<script type=\"module\" src=\"https://unpkg.com/ionicons@8.1.0/dist/ionicons/ionicons.esm.js\"></script>",
   "why": "On 2026-11-09 the usage page printed \"undefined\" where the version belongs, so the copied address points to no release.",
   "dont_code": false,
   "fix_code": true
  },
  {
   "dont": "<script type=\"module\" src=\"https://esm.sh/ionicons@latest/loader\"></script> in production",
   "fix": "A fixed version, e.g. the 8.1.0 file above, or the npm package with setAssetPath",
   "why": "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.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "<ion-icon name=\"logo-github-outline\">",
   "fix": "<ion-icon name=\"logo-github\">",
   "why": "Logo icons have no outline or sharp version.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "<button><ion-icon name=\"heart\"></ion-icon></button> with no label",
   "fix": "<button aria-label=\"Favorite\"><ion-icon name=\"heart\" aria-hidden=\"true\"></ion-icon></button>",
   "why": "Interactive icons need alternate text, and decorative ones should be hidden from screen readers.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Setting --ionicon-stroke-width on a filled icon like name=\"heart\"",
   "fix": "Use the outline variant (heart-outline) when you want a thinner or thicker line",
   "why": "Only outline icons have a line width to change.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install ionicons",
  "repo": "https://github.com/ionic-team/ionicons",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "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>.",
  "formats": [
   "svg"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Icons: Ionicons by Ionic (MIT)",
  "rules_text": "- Ionicons (Icons). An open-source icon set from Ionic, distributed under the MIT License. Price: free; commercial use OK; no credit needed.\n  Connect: npm ionicons.\n  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).\n  Rule: Keep the MIT license file and copyright notice with any copies of the icons you ship.\n  Rule: Do not remove the Ionic copyright notice from distributed files.\n  License: https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/ionicons/)",
  "agent_md": "https://agentgid.com/assets/ionicons/agent.md",
  "card_json": "https://agentgid.com/assets/ionicons/card.json"
 },
 "popularity": {
  "gid_score": 44,
  "stars": 18253,
  "downloads_7d": 890276,
  "downloads_7d_label": "890.3K",
  "downloads_change_4w_pct": 0.2,
  "eco": "npm",
  "package": "ionicons",
  "repo": "ionic-team/ionicons",
  "agent_projects": 1,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     558916
    ],
    [
     "2025-11-24",
     506044
    ],
    [
     "2025-12-01",
     539855
    ],
    [
     "2025-12-08",
     512983
    ],
    [
     "2025-12-15",
     499069
    ],
    [
     "2025-12-22",
     327028
    ],
    [
     "2025-12-29",
     292862
    ],
    [
     "2026-01-05",
     486323
    ],
    [
     "2026-01-12",
     509572
    ],
    [
     "2026-01-19",
     534554
    ],
    [
     "2026-01-26",
     553356
    ],
    [
     "2026-02-02",
     597465
    ],
    [
     "2026-02-09",
     613221
    ],
    [
     "2026-02-16",
     587119
    ],
    [
     "2026-02-23",
     611099
    ],
    [
     "2026-03-02",
     623401
    ],
    [
     "2026-03-09",
     669673
    ],
    [
     "2026-03-16",
     637937
    ],
    [
     "2026-03-23",
     639338
    ],
    [
     "2026-03-30",
     584760
    ],
    [
     "2026-04-06",
     594505
    ],
    [
     "2026-04-13",
     636718
    ],
    [
     "2026-04-20",
     609862
    ],
    [
     "2026-04-27",
     615322
    ],
    [
     "2026-05-04",
     617912
    ],
    [
     "2026-05-11",
     677431
    ],
    [
     "2026-05-18",
     659314
    ],
    [
     "2026-05-25",
     612092
    ],
    [
     "2026-06-01",
     666346
    ],
    [
     "2026-06-08",
     729824
    ],
    [
     "2026-06-15",
     737757
    ],
    [
     "2026-06-22",
     700325
    ],
    [
     "2026-06-29",
     668576
    ],
    [
     "2026-07-06",
     709665
    ],
    [
     "2026-07-13",
     716607
    ],
    [
     "2026-07-20",
     749730
    ],
    [
     "2026-07-27",
     739815
    ],
    [
     "2026-08-03",
     760238
    ],
    [
     "2026-08-10",
     757187
    ],
    [
     "2026-08-17",
     733733
    ],
    [
     "2026-08-24",
     731918
    ],
    [
     "2026-08-31",
     797804
    ],
    [
     "2026-09-07",
     537290
    ],
    [
     "2026-09-14",
     745359
    ],
    [
     "2026-09-21",
     959602
    ],
    [
     "2026-09-28",
     967009
    ],
    [
     "2026-10-05",
     827905
    ],
    [
     "2026-10-12",
     662917
    ],
    [
     "2026-10-19",
     688799
    ],
    [
     "2026-10-26",
     951106
    ],
    [
     "2026-11-02",
     894595
    ],
    [
     "2026-11-09",
     890276
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     18239
    ],
    [
     "2026-11-08",
     18240
    ],
    [
     "2026-11-09",
     18242
    ],
    [
     "2026-11-10",
     18243
    ],
    [
     "2026-11-11",
     18244
    ],
    [
     "2026-11-12",
     18244
    ],
    [
     "2026-11-13",
     18244
    ],
    [
     "2026-11-14",
     18245
    ],
    [
     "2026-11-15",
     18247
    ],
    [
     "2026-11-16",
     18248
    ],
    [
     "2026-11-17",
     18253
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "ionicons",
   "name": "Ionicons",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "material-symbols",
   "name": "Material Symbols",
   "why": "Pick Material Symbols for Google's own Android look, served as one adjustable icon font.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "MCP"
  },
  {
   "slug": "lucide",
   "name": "Lucide",
   "why": "Pick Lucide for a larger set of line icons with ready packages for React, Vue, Svelte and Angular.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tabler-icons",
   "name": "Tabler Icons",
   "why": "Pick Tabler Icons for a much larger MIT set with outline and filled versions.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "material-design-icons-pictogrammers",
   "name": "Material Design Icons (Pictogrammers)",
   "why": "Community Material Design icon set (7,000+ icons, as reported) as SVG, webfont and JS packages (@mdi/js, @mdi/font).",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "carbon-icons",
   "name": "Carbon Icons",
   "why": "IBM Carbon Design System icon set and pictograms as SVG and React/Vue packages.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use Ionicons in a paid app?",
   "a": "Yes. The icons are MIT licensed and free for personal or commercial use; keep the license notice with copies of the files."
  },
  {
   "q": "Do I need the Ionic toolkit?",
   "a": "No. Ionic apps include Ionicons already; any other web page can load the ion-icon component with one script tag."
  },
  {
   "q": "How do I get the outline or sharp version?",
   "a": "Add -outline or -sharp to the icon name, like heart-outline; the plain name is the filled one. Logo icons have only one version."
  },
  {
   "q": "Can I use my own SVG file with it?",
   "a": "Yes, pass its address in src. The file must be a valid SVG without scripts or events."
  },
  {
   "q": "Can I use brand logos like social networks?",
   "a": "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."
  }
 ],
 "at_a_glance": {
  "latest_version": "8.1.0",
  "last_release": "2026-07-28",
  "last_commit": "2026-07-28",
  "runtime": "A browser with Chrome 79+, Safari 14+, Edge 79+ or Firefox 70+ (no IE 11); the package depends on @stencil/core ^4.43.5.",
  "key_needed": false,
  "formats": "svg"
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [
  "about 1,300 icons for web, iOS, Android and desktop apps"
 ],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "ionic.io/ionicons",
    "url": "https://ionic.io/ionicons"
   },
   {
    "label": "ionic.io/ionicons/usage",
    "url": "https://ionic.io/ionicons/usage"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/ionic-team/ionicons/blob/main/readme.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/ionic-team/ionicons/blob/main/LICENSE"
   },
   {
    "label": "npm: ionicons/latest",
    "url": "https://registry.npmjs.org/ionicons/latest"
   },
   {
    "label": "npm: ionicons/8.1.0",
    "url": "https://registry.npmjs.org/ionicons/8.1.0"
   },
   {
    "label": "api.github.com/repos/ionic-team/ionicons",
    "url": "https://api.github.com/repos/ionic-team/ionicons"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/ionic-team/ionicons/blob/HEAD/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/ionicons/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
