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

Material Design Icons (Pictogrammers)

by Pictogrammers

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

Icons Code libraryOpen sourceflatoutline

GitHub repoWebsite
A sidebar menu, twelve icons each shown filled and as an outline, and six dashboard tiles with a lamp, thermometer, fan, locked door, humidity and weather icon.
Made by AgentGid with @mdi/js 7.4.47 (npm). The icons are under the Pictogrammers Free License (Apache 2.0 for the icons), which allows commercial use and redistribution; no brand or logo icons are shown.

2. Commercial use: pictogrammers.com/docs/general/license

“for commercial projects, open-source projects, or anything really.”

Allowed for commercial projects; brand and logo icons are excluded.

pictogrammers.com/docs/general/license

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

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 you can 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

Filled for on, outline for off Idea

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.

Smart home and device screens Idea

The set has many icons for rooms, lights, temperature, doors and weather. They suit a home or device dashboard.

As reported by Pictogrammers: over 7200 unique icons in Material Design Icons; 80 new icons in the 7.4.47 release.

Material Design Icons (Pictogrammers) popularity

45 / 100
Gid Score, same scale as developer tools
11,317
GitHub stars
837.9K
npm downloads, last 7 days
+24.4% in 4 weeks
4
AI-agent projects using it, from our repo scan of 4,817
Material Design Icons (Pictogrammers): downloads per weeknpm, @mdi/js 837,934
Material Design Icons (Pictogrammers): GitHub starsTemplarian/MaterialDesign 11,317

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 Material Design Icons with @mdi/react 1.6.1 and @mdi/js 7.4.47 at fixed versions, import only the icons you use, give icon-only buttons an aria-label, and take brand logos from Simple Icons instead.”

Or install it yourself. For React, install the small React wrapper and the icon data package.

npm install @mdi/react @mdi/js
Show code

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

npm install @mdi/svg

Mistakes to avoid

The hosted icon font link on a live site
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.

Using mdiGithub, mdiDiscord or other company logos from this set
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.

Updating @mdi/js across a major version without checking names
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.

<span class="mdi mdi-account mdi-flip-h mdi-rotate-45"></span>
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.

<button><Icon path={mdiAccount} /></button> with no label
<button aria-label="User Profile"><Icon path={mdiAccount} /></button>

An icon without a title is treated as decoration and ignored by screen readers.

License

Pictogrammers Free License (Apache 2.0). 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.

Commercial use
Yes

“for commercial projects, open-source projects, or anything really.” pictogrammers.com/docs/general/license

Credit
Not needed

“for commercial projects, open-source projects, or anything really.” pictogrammers.com/docs/general/license

Inside your app or game
Can ship inside your app

“for commercial projects, open-source projects, or anything really.” pictogrammers.com/docs/general/license

Pass the files on to your users
Allowed

“Some of the icons are redistributed under the Apache 2.0 license.” pictogrammers.com/docs/general/license

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is Material Design Icons (Pictogrammers) 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 Material Design Icons (Pictogrammers). Paste them into your prompt or AGENTS.md.

License rules
- 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/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install @mdi/js
How an agent gets files
npm install @mdi/js (SVG paths) or @mdi/font (webfont); or copy SVG from pictogrammers.com. No account.

Formats: svg, woff2, js

API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Icons: Material Design Icons by Pictogrammers (pictogrammers.com), Apache License 2.0
This card for machines

Alternatives

Material Design Icons (Pictogrammers) This page

Free Commercial OK npm

Material Symbols

Pick Material Symbols for Google's own Material icons as a variable icon font, under Apache 2.0.

Free Commercial OK MCP

Tabler Icons

Pick Tabler Icons for a large MIT set of line icons with filled versions and packages for many frameworks.

Free Commercial OK npm

Phosphor Icons

Pick Phosphor when you want every icon in six weights, from thin to two-tone.

Free Commercial OK npm

Ionicons

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

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