# Material Design Icons (Pictogrammers) — card for AI agents

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

Category: Icons · maker Pictogrammers · checked 2026-11-05 · style: flat, outline

## Price
- Price: Free
- Free tier: Fully free.

## License
Pictogrammers Free License (Apache 2.0) — https://pictogrammers.com/docs/general/license/

- commercial: **yes** (Commercial use OK)
  > for commercial projects, open-source projects, or anything really.
  (https://pictogrammers.com/docs/general/license/)
- attribution: **no** (No credit needed)
  > for commercial projects, open-source projects, or anything really.
  (https://pictogrammers.com/docs/general/license/)
- in app: **yes** (Can ship inside your app)
  > for commercial projects, open-source projects, or anything really.
  (https://pictogrammers.com/docs/general/license/)
- redistribute: **yes** (Can pass the files on to your own users)
  > Some of the icons are redistributed under the Apache 2.0 license.
  (https://pictogrammers.com/docs/general/license/)

## Rules to follow
- Apache-2.0: keep the license with redistributed files
- A few brand icons carry their own licenses/trademarks

## 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 @mdi/js (SVG paths) or @mdi/font (webfont); or copy SVG from pictogrammers.com. No account. (sign-in: none)
- Formats: svg, woff2, js
- Not allowed: Apache-2.0 notice

## How to connect
- Package (npm/PyPI)
- npm: `npm install @mdi/js`
- Repository: https://github.com/Templarian/MaterialDesign
- Website: https://pictogrammers.com/library/mdi/

## Notes
Different from Google's Material Symbols (already in the catalog).

## Numbers (AgentGid data)
- Gid Score: 45
- GitHub stars: 11,317
- Downloads last week: 837,934
- Used in 4 public projects set up for AI coding agents

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

```
- Material Design Icons (Pictogrammers) (Icons). Community Material Design icon set (7,000+ icons, as reported) as SVG, webfont and JS packages (@mdi/js, @mdi/font). Price: free; commercial use OK; no credit needed. Style: flat, outline.
  Connect: npm @mdi/js.
  Get files: npm install @mdi/js (SVG paths) or @mdi/font (webfont); or copy SVG from pictogrammers.com. No account (svg, woff2, js).
  Not allowed: Apache-2.0 notice
  Rule: Apache-2.0: keep the license with redistributed files
  Rule: A few brand icons carry their own licenses/trademarks
  License: https://pictogrammers.com/docs/general/license/ (checked 2026-11-05; details: https://agentgid.com/assets/material-design-icons-pictogrammers/)
```

## Links
- AgentGid page: https://agentgid.com/assets/material-design-icons-pictogrammers/
- Is it free for commercial use? https://agentgid.com/assets/material-design-icons-pictogrammers/commercial-use/
- Source: https://pictogrammers.com/library/mdi/
- Source: https://pictogrammers.com/docs/general/license/
- Source: https://raw.githubusercontent.com/Templarian/MaterialDesign/HEAD/LICENSE


## Material Design Icons: over 7,000 free app icons

Material Design Icons is a large free icon set made by a volunteer group called Pictogrammers. Its icons follow Google's Material look and many come as a filled and an outline version. You or your AI assistant add them to a site or app as image files, code or an icon font. It is a separate project from Google's own Material Symbols.

### Where to use it
- Icons in a React app: Add one icon at a time to buttons and menus; the icon's drawing comes from a separate data package. Size, color, flip, rotation and a spin are set on the icon.
- Icons as small image files: Use an icon file in an image tag, or paste its drawing straight into the page so it takes your text color. The docs call this the preferred way for the web.
- Quick prototype with the icon font: For a demo or an early draft, link one style file and write the icon name as a class, like mdi-home. Switch to image files or code before launch.
- A spinner while something loads: Show a turning loading icon next to "Processing" while a form saves or a file uploads.
- Filled for on, outline for off: Many icons come in pairs, like heart and heart-outline. Use the filled one for a saved item or an active tab and the outline one for the rest. (idea, not from the official pages)
- Smart home and device screens: The set has many icons for rooms, lights, temperature, doors and weather. They suit a home or device dashboard. (idea, not from the official pages)

### How to start
- For React, install the small React wrapper and the icon data package.

```
npm install @mdi/react @mdi/js
```

- For plain icon files, install @mdi/svg and use the file you need.

```
npm install @mdi/svg
```

- Find icon names in the library on the Pictogrammers site; in code the names are camel case with an mdi prefix, like mdiAccount.

### License
Free for paid and personal projects, with no visible credit needed. The icons and fonts are under Apache 2.0, so keep the license file when you pass the files on. Brand and logo icons are not covered.

### Good to know
- Brand and logo icons are not covered by the license and are being removed, so take company logos from somewhere else.
- The icon font is the quickest setup but loads every icon, and the docs advise against it for live sites.
- Icons are drawn to look sharp at 24 pixels, which is 1.5 times a normal 16 pixel text size.
- Big version jumps rename or remove some icons. Pin a version and read the upgrade guide before you update.
- The newest package release is 7.4.47 from December 2023, so new icons arrive slowly.

Checked 2026-11-09 against: https://pictogrammers.com/, https://pictogrammers.com/library/mdi/, https://pictogrammers.com/docs/general/license/, https://pictogrammers.com/docs/library/mdi/getting-started/getting-started/, https://pictogrammers.com/docs/library/mdi/getting-started/webfont/, https://pictogrammers.com/docs/library/mdi/getting-started/react/, https://pictogrammers.com/docs/library/mdi/getting-started/svg/, https://pictogrammers.com/docs/library/mdi/releases/upgrade/, https://github.com/Templarian/MaterialDesign/blob/HEAD/README.md, https://github.com/Templarian/MaterialDesign/blob/HEAD/LICENSE, https://www.apache.org/licenses/LICENSE-2.0, https://registry.npmjs.org/@mdi/js, https://registry.npmjs.org/@mdi/js/latest, https://registry.npmjs.org/@mdi/react/latest, https://registry.npmjs.org/@mdi/font/latest, https://registry.npmjs.org/@mdi/svg/latest

### Mistakes to avoid
- Don't: The hosted icon font link on a live site → Do: Use @mdi/js with @mdi/react, or single files from @mdi/svg, so only the icons you use are loaded (The font carries every icon and the docs discourage it for performance.)
- Don't: Using mdiGithub, mdiDiscord or other company logos from this set → Do: Take logos from Simple Icons or from the brand's own press kit (Brand icons are not covered by the license and are being removed; discord was already removed in 7.0.)
- Don't: Updating @mdi/js across a major version without checking names → Do: Pin the version and follow the upgrade guide for renamed icons (for example email-send became email-arrow-right) (Removed or renamed icons stop resolving after the update.)
- Don't: <span class="mdi mdi-account mdi-flip-h mdi-rotate-45"></span> → Do: Use either a flip class or a rotate class on one element, or wrap the icon and rotate the wrapper (The two helper classes do not combine on the same element.)
- Don't: <button><Icon path={mdiAccount} /></button> with no label → Do: <button aria-label="User Profile"><Icon path={mdiAccount} /></button> (An icon without a title is treated as decoration and ignored by screen readers.)

### Questions
- Can I use these icons in a paid app or a client project? Yes. The license allows commercial projects, open-source projects or anything else.
- Is this the same as Google's Material Symbols? No. It is a separate set from the Pictogrammers group that follows Google's guidelines and includes converted icons from Google's official set.
- Can I use the logos of companies from this set? No. The Brand / Logos icons are not covered by the license and are being removed.
- How do I make the icons readable for screen readers? In React, give the icon a title; without a title it is treated as decoration and skipped. On an icon-only button, put an aria-label on the button.

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