{
 "slug": "carbon-icons",
 "name": "Carbon Icons",
 "author": "IBM",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "IBM Carbon Design System icon set and pictograms as SVG and React/Vue packages.",
 "category": {
  "slug": "icons",
  "name": "Icons"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "outline",
  "corporate",
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/carbon-design-system.png",
 "logo_letter": "C",
 "links": {
  "repo": "https://github.com/carbon-design-system/carbon",
  "website": "https://carbondesignsystem.com/elements/icons/library/",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/carbon-icons/demo.jpg",
  "alt": "A database list with a sidebar, a toolbar and status marks, one icon at 16, 20, 24 and 32 pixels, and 24 icons from the set.",
  "caption": "Made by AgentGid with @carbon/icons 11.92.0 (npm). Carbon icons are under the Apache License 2.0, which allows showing and passing on the files with a copy of the license. No brand logos from the set (logo--* files) are shown."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "carbondesignsystem.com/elements/icons/library",
    "url": "https://carbondesignsystem.com/elements/icons/library/"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache-2.0",
   "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
   "note": "The Apache 2.0 license allows use in paid products at no charge.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/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 @carbon/icons. No key or account is needed.",
   "source": {
    "label": "github.com/carbon-design-system/carbon",
    "url": "https://github.com/carbon-design-system/carbon"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0",
  "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE",
  "summary": "Free for personal and paid products under the Apache 2.0 license, with no visible credit needed. When you pass the files on, include a copy of the license. The license does not let you use IBM's names or trademarks.",
  "pages_read": 1,
  "rules": [
   "Keep the Apache-2.0 license with redistributed files",
   "IBM logos/marks are not part of the license grant"
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/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/carbon-icons/commercial-use/"
 },
 "overview": {
  "heading": "Carbon icons: IBM's free icons for business apps",
  "body": "Carbon icons are the free icons of IBM's Carbon Design System, made for business software such as dashboards, data tables and cloud consoles. You or your AI assistant add them to a website or app as ready pieces in four fixed sizes. They are free to use in paid products under the Apache 2.0 license."
 },
 "uses": [
  {
   "title": "Toolbars and menus in a React app",
   "text": "Each icon is its own piece you place on a screen, such as a filter or download button above a table. You pick one of four sizes; the default is 16 pixels.",
   "idea": false,
   "image": null
  },
  {
   "title": "Status marks in data tables",
   "text": "Show Running, Degraded or Stopped next to each row with filled check, warning and error marks. Some marks take a second color for the inner sign, such as a dark exclamation point on yellow.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icons on a page without a framework",
   "text": "Plain JavaScript pages can import one icon at one size and turn it into a picture on the page with a small helper.",
   "idea": false,
   "image": null
  },
  {
   "title": "Larger pictures for empty pages",
   "text": "For a bigger picture on an empty page, a welcome screen or a landing page, Carbon has separate pictograms. They are simple illustrations, not small interface icons.",
   "idea": false,
   "image": null
  },
  {
   "title": "Cloud and data consoles",
   "text": "The set has many icons for servers, databases, containers and monitoring, which suits admin panels and cloud tools.",
   "idea": true,
   "image": null
  },
  {
   "title": "Icons as plain image files",
   "text": "Copy single icon files for slides, documents or pages made on a server, with no script running in the browser.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add Carbon icons with @carbon/icons-react at a fixed version: dashboard, database, security and settings in the sidebar at size 16, filled check, warning and error marks in the status column, and an aria-label on icon-only buttons; set IBM_TELEMETRY_DISABLED=true in CI.",
  "install": "npm install -S @carbon/icons-react",
  "install_note": "Add the React package to your project (there are also packages for plain JavaScript and Vue).",
  "code": [
   {
    "tab": "Step 1",
    "intro": "Import an icon by name and choose a size of 16, 20, 24 or 32.",
    "source": "import { Add } from '@carbon/icons-react';\n\nfunction ExampleComponent() {\n  return <Add size={32} />;\n}"
   },
   {
    "tab": "Step 2",
    "intro": "To have a screen reader announce an icon, give it an aria-label.",
    "source": "<button>\n  <Add aria-label=\"Add\" />\n</button>"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "<Add size={18} /> or other sizes outside the four sizes",
   "fix": "<Add size={16} />, or 20, 24 or 32",
   "why": "The icons are drawn for 16, 20, 24 and 32 pixels only.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "svg [data-icon-path=\"inner-path\"] { fill: black; } without opacity",
   "fix": "svg [data-icon-path=\"inner-path\"] { fill: black; opacity: 1; }",
   "why": "The inner sign of two-color icons stays invisible until its opacity is set to 1.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "An icon-only <button><TrashCan /></button> with no label",
   "fix": "<button><TrashCan aria-label=\"Delete\" /></button>",
   "why": "Icons are hidden from screen readers by default until they get an aria-label.",
   "dont_code": false,
   "fix_code": true
  },
  {
   "dont": "Running npm install in CI without knowing that the package reports usage",
   "fix": "Set IBM_TELEMETRY_DISABLED='true' in the CI environment if the project must not report anything",
   "why": "The packages report anonymized usage to IBM from build servers by default.",
   "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 @carbon/icons",
  "repo": "https://github.com/carbon-design-system/carbon",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install @carbon/icons (or @carbon/icons-react); or download SVG from the Carbon icon library page. No account.",
  "formats": [
   "svg",
   "jsx"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Icons: Carbon Design System by IBM, Apache License 2.0",
  "rules_text": "- Carbon Icons (Icons). IBM Carbon Design System icon set and pictograms as SVG and React/Vue packages. Price: free; commercial use OK; no credit needed. Style: outline, corporate, minimal.\n  Connect: npm @carbon/icons.\n  Get files: npm install @carbon/icons (or @carbon/icons-react); or download SVG from the Carbon icon library page. No account (svg, jsx).\n  Not allowed: Apache-2.0 notice\n  Rule: Keep the Apache-2.0 license with redistributed files\n  Rule: IBM logos/marks are not part of the license grant\n  License: https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/carbon-icons/)",
  "agent_md": "https://agentgid.com/assets/carbon-icons/agent.md",
  "card_json": "https://agentgid.com/assets/carbon-icons/card.json"
 },
 "popularity": {
  "gid_score": 44,
  "stars": 9628,
  "downloads_7d": 98632,
  "downloads_7d_label": "98.6K",
  "downloads_change_4w_pct": 28.6,
  "eco": "npm",
  "package": "@carbon/icons",
  "repo": "carbon-design-system/carbon",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     70366
    ],
    [
     "2025-11-24",
     70699
    ],
    [
     "2025-12-01",
     68073
    ],
    [
     "2025-12-08",
     92182
    ],
    [
     "2025-12-15",
     70855
    ],
    [
     "2025-12-22",
     31514
    ],
    [
     "2025-12-29",
     30859
    ],
    [
     "2026-01-05",
     70738
    ],
    [
     "2026-01-12",
     69264
    ],
    [
     "2026-01-19",
     91445
    ],
    [
     "2026-01-26",
     67810
    ],
    [
     "2026-02-02",
     92372
    ],
    [
     "2026-02-09",
     139156
    ],
    [
     "2026-02-16",
     138998
    ],
    [
     "2026-02-23",
     184555
    ],
    [
     "2026-03-02",
     122898
    ],
    [
     "2026-03-09",
     127490
    ],
    [
     "2026-03-16",
     119524
    ],
    [
     "2026-03-23",
     171761
    ],
    [
     "2026-03-30",
     224421
    ],
    [
     "2026-04-06",
     113023
    ],
    [
     "2026-04-13",
     102575
    ],
    [
     "2026-04-20",
     167903
    ],
    [
     "2026-04-27",
     165641
    ],
    [
     "2026-05-04",
     188259
    ],
    [
     "2026-05-11",
     196584
    ],
    [
     "2026-05-18",
     213679
    ],
    [
     "2026-05-25",
     131800
    ],
    [
     "2026-06-01",
     137351
    ],
    [
     "2026-06-08",
     142190
    ],
    [
     "2026-06-15",
     118862
    ],
    [
     "2026-06-22",
     147407
    ],
    [
     "2026-06-29",
     216980
    ],
    [
     "2026-07-06",
     164011
    ],
    [
     "2026-07-13",
     154421
    ],
    [
     "2026-07-20",
     270984
    ],
    [
     "2026-07-27",
     189476
    ],
    [
     "2026-08-03",
     202358
    ],
    [
     "2026-08-10",
     209639
    ],
    [
     "2026-08-17",
     172362
    ],
    [
     "2026-08-24",
     127613
    ],
    [
     "2026-08-31",
     126109
    ],
    [
     "2026-09-07",
     67569
    ],
    [
     "2026-09-14",
     133080
    ],
    [
     "2026-09-21",
     116663
    ],
    [
     "2026-09-28",
     118881
    ],
    [
     "2026-10-05",
     106394
    ],
    [
     "2026-10-12",
     75972
    ],
    [
     "2026-10-19",
     84941
    ],
    [
     "2026-10-26",
     245757
    ],
    [
     "2026-11-02",
     108298
    ],
    [
     "2026-11-09",
     98632
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     9608
    ],
    [
     "2026-11-08",
     9608
    ],
    [
     "2026-11-09",
     9610
    ],
    [
     "2026-11-10",
     9612
    ],
    [
     "2026-11-11",
     9614
    ],
    [
     "2026-11-12",
     9615
    ],
    [
     "2026-11-13",
     9619
    ],
    [
     "2026-11-14",
     9621
    ],
    [
     "2026-11-15",
     9624
    ],
    [
     "2026-11-16",
     9628
    ],
    [
     "2026-11-17",
     9628
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "carbon-icons",
   "name": "Carbon Icons",
   "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 Apache 2.0 icon set delivered as a variable icon font with adjustable weight and fill.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "MCP"
  },
  {
   "slug": "lucide",
   "name": "Lucide",
   "why": "Pick Lucide for thin outline icons with an adjustable line width and packages for many frameworks.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tabler-icons",
   "name": "Tabler Icons",
   "why": "Pick Tabler Icons for a larger MIT set with both 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": "ionicons",
   "name": "Ionicons",
   "why": "An open-source icon set from Ionic, distributed under the MIT License.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use Carbon icons in a paid product that is not built by IBM?",
   "a": "Yes. The Apache 2.0 license is free, worldwide and royalty-free; include a copy of the license when you pass the files on."
  },
  {
   "q": "What sizes are there?",
   "a": "16, 20, 24 and 32 pixels; the default in React is 16."
  },
  {
   "q": "How do I change the color?",
   "a": "Set the fill with a CSS class (the preferred way) or an inline style."
  },
  {
   "q": "Do the icons send any data?",
   "a": "Not from your users' browsers. The install step reports anonymized usage to IBM only on build servers, and an environment setting turns it off."
  }
 ],
 "at_a_glance": {
  "latest_version": "11.92.0",
  "last_release": "2026-11-04",
  "last_commit": "2026-11-17",
  "runtime": "React 16+ (peer: react >=16). Plain JavaScript uses @carbon/icons with @carbon/icon-helpers. Our demo used the SVG files of @carbon/icons 11.92.0.",
  "key_needed": false,
  "formats": "svg, jsx"
 },
 "good_to_know": [
  "Installing the packages turns on IBM usage reporting, but only on build servers and in containers, not on your own computer. Setting IBM_TELEMETRY_DISABLED to true turns it off.",
  "Icons come in four sizes, 16, 20, 24 and 32 pixels; keep one size per place across your product.",
  "Icons are solid, one-color shapes and need the same contrast as text, 4.5 to 1.",
  "Clickable icons need a touch area of at least 44 pixels; add space around a small icon to reach it.",
  "Pictograms are illustrations, not a stand-in for small interface icons, and are not meant to serve as logos."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "carbondesignsystem.com/elements/icons/library",
    "url": "https://carbondesignsystem.com/elements/icons/library/"
   },
   {
    "label": "carbondesignsystem.com/elements/icons/usage",
    "url": "https://carbondesignsystem.com/elements/icons/usage/"
   },
   {
    "label": "carbondesignsystem.com/elements/icons/code",
    "url": "https://carbondesignsystem.com/elements/icons/code/"
   },
   {
    "label": "carbondesignsystem.com",
    "url": "https://carbondesignsystem.com/elements/pictograms/library/"
   },
   {
    "label": "carbondesignsystem.com/elements/pictograms/usage",
    "url": "https://carbondesignsystem.com/elements/pictograms/usage/"
   },
   {
    "label": "carbondesignsystem.com/elements/pictograms/code",
    "url": "https://carbondesignsystem.com/elements/pictograms/code/"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/LICENSE"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/packages/icons/README.md"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/carbon-design-system/carbon/main/packages/icons-react/README.md"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/README.md"
   },
   {
    "label": "npm: @carbon/icons/11.92.0",
    "url": "https://registry.npmjs.org/@carbon/icons/11.92.0"
   },
   {
    "label": "npm: @carbon/icons-react/11.92.0",
    "url": "https://registry.npmjs.org/@carbon/icons-react/11.92.0"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/carbon-icons/",
 "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."
}
