Material Symbols covers 20 to 48 px with 4 variable axes
Material Symbols is the current family, introduced in April 2022 and built as variable fonts. Its 3 styles are Outlined, Rounded, and Sharp. CSS can vary optical size from 20 to 48 px, weight from 100 to 700, grade from -50 to 200, and fill from 0 to 100. Static files do not contain every possible combination, so the variable fonts carry the set's full range.
Classic Material Icons has 5 fixed styles: Outlined, Filled, Rounded, Sharp, and Two Tone. It has no variable weights, grades, or animated fill transition, and Google stopped adding icons in 2022. A move to Symbols can change font names, available styles, and rendering controls. Teams keeping the classic set must accept its fixed catalog instead of expecting current Symbols to appear there.
Only the 20 px and 24 px Symbol designs are pixel-grid aligned
The shortest web setup is a Google Fonts stylesheet link for either icon family. The repository also carries pre-generated fonts, variable fonts, source files, Android and iOS assets, and PNGs. Only the 20 px and 24 px Symbol designs receive exact pixel-grid alignment. At other optical sizes, teams with strict rendering requirements should inspect the result on their target displays rather than assume every size was hand-fitted.
Self-hosting is allowed under the Apache License 2.0, and attribution is appreciated rather than required. A local pipeline can pin font or SVG files and avoid a Google Fonts request. The symbols and variablefont directories hold current Symbols material. The android, font, ios, png, and src directories contain classic assets. Mixing those directories without choosing one set makes asset drift harder to spot.
What happened when we ran it
Our sandbox had 3 CPUs and 8 GB RAM, and git clone failed on September 7, 2026. The run stopped before any install, build, or test command started. The lab record has no error detail beyond the failed clone, so it does not support a diagnosis. We cannot say whether the update tooling works in a clean Debian container, and there is no test outcome for a checked-out commit.
The 3-CPU run also left dependency count, disk use, timings, and vulnerabilities unknown. The README presents the repository mainly as generated assets and sends web users to the Google Fonts guides. Hosted icons therefore have a documented route that avoids cloning. A team requiring reproducible local assets should make successful retrieval and checksum pinning its first trial because our 8 GB container reached neither step.
Google's npm publishing stopped at v3 in 2016
Google no longer maintains this repository's npm package beyond v3, released in 2016. The README links Marella's packages for variable fonts, fixed-weight fonts, and optimized SVGs, while stating that Google does not monitor or vet them. npm users should assess marella/material-symbols as a separate dependency, pin its version, and review its publishing chain instead of treating the README link as a Google endorsement.
Google welcomes icon concepts as GitHub issues but rejects finished icon-file pull requests. The repository is generated from upstream sources, and its designs follow strict internal guidelines. Third-party logos are excluded for legal reasons, including some logos that were later removed. Product teams needing company marks must source them elsewhere. Designers seeking an icon set that accepts community-drawn SVGs will find a poor fit here.
Two 2026 glyph reports justify visual regression tests
Issue 2024 reported 3 canonical codepoints missing from Material Symbols 2.966 after formerly unified icons were separated. A collaborator explained that the official Google Fonts codepoint had not changed, while an extra codepoint disappeared; the reporter said direct references displayed tofu. Issue 2025 reported an incorrect filled battery symbol. A collaborator checked a fix into the compiled variable fonts 2 days later but gave no firm hosted-release date.
The 2 reports show how a font update can affect codepoint references and fill rendering. Ligature names, codepoint files, hosted fonts, and checked-in assets may move on different schedules. Pin self-hosted files, capture screenshots of important controls, and verify codepoint integrations after an update. With Google Fonts, test the live font before a broad rollout because the application does not control when a corrected binary appears.
September 2026 commits outweigh the 2020 release tag
The latest GitHub release is v4.0.0 from August 2020, yet the default branch received an Update Symbols commit on September 4, 2026 after similar summer updates. GitHub listed 53,899 stars, 414 open issues, and 12 open pull requests on September 8. Maintainer replies and checked-in glyph fixes sit beside a large request queue. The evidence describes an active asset feed with an old formal release.
Material Symbols is a good choice when a product already uses Google's design language and needs 4 adjustable axes. The repository is a weak npm entry point and does not cover brand logos or community-designed additions. Start with the hosted font for an interface trial. For production self-hosting, select one set, pin exact assets, and test the icons users act on. Our failed clone leaves the repository workflow unproven.