Simple Icons

Simple Icons

Over 2600 Free SVG icons for popular brands. See them all on one page at SimpleIcons.org. Contributions, corrections & requests can be made on GitHub.

Build status NPM version Build status
Number of icons currently in the library Number of users active in our Discord server Backers and sponsors on Open Collective

## Usage > **Note**\ > We ask that all users read our [legal disclaimer](https://github.com/simple-icons/simple-icons/blob/develop/DISCLAIMER.md) before using icons from Simple Icons. ### General Usage Icons can be downloaded as SVGs directly from [our website](https://simpleicons.org/) - simply click the download button of the icon you want, and the download will start automatically. ### CDN Usage Icons can be served from a CDN such as [jsDelivr](https://www.jsdelivr.com/package/npm/simple-icons) or [Unpkg](https://unpkg.com/browse/simple-icons/). Simply use the `simple-icons` npm package and specify a version in the URL like the following: ```html ``` Where `[ICON SLUG]` is replaced by the [slug] of the icon you want to use, for example: ```html ``` These examples use the latest major version. This means you won't receive any updates following the next major release. You can use `@latest` instead to receive updates indefinitely. However, this will result in a `404` error if the icon is removed. #### CDN with colors We also provide a CDN service which allows you to use colors. ```html ``` Where `[COLOR]` is optional, and can be replaced by the [hex colors](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color) or [CSS keywords](https://www.w3.org/wiki/CSS/Properties/color/keywords) of the icon you want to you use. The color is defaulted to the HEX color of the icon shown in [simpleicons.org website](https://simpleicons.org). `[DARK_MODE_COLOR]` is used for dark mode. The [CSS prefers-color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme) will be used when a value is specified. For example: ```html ``` ### Node Usage Node The icons are also available through our npm package. To install, simply run: ```shell npm install simple-icons ``` All icons are imported from a single file, where `[ICON SLUG]` is replaced by a capitalized [slug]. We highly recommend using a bundler that can tree shake such as [webpack](https://webpack.js.org/) to remove the unused icon code: ```javascript // Import a specific icon by its slug as: // import { si[ICON SLUG] } from 'simple-icons' // For example: // use import/esm to allow tree shaking import { siSimpleicons } from 'simple-icons'; // or with require/cjs const { siSimpleicons } = require('simple-icons'); ``` It will return an icon object: ```javascript console.log(siSimpleicons); /* { title: 'Simple Icons', slug: 'simpleicons', hex: '111111', source: 'https://simpleicons.org/', svg: '...', path: 'M12 12v-1.5c-2.484 ...', guidelines: 'https://simpleicons.org/styleguide', license: { type: '...', url: 'https://example.com/' } } NOTE: the `guidelines` entry will be `undefined` if we do not yet have guidelines for the icon. NOTE: the `license` entry will be `undefined` if we do not yet have license data for the icon. */ ``` If you need to iterate over all icons, use: ```javascript import * as icons from 'simple-icons'; ``` #### TypeScript Usage Typescript Type definitions are bundled with the package. ```typescript import type { SimpleIcon } from 'simple-icons'; ``` ### PHP Usage Php The icons are also available through our Packagist package. To install, simply run: ```shell composer require simple-icons/simple-icons ``` The package can then be used as follows, where `[ICON SLUG]` is replaced by a [slug]: ```php ... ?> ``` ## Third-Party Extensions | Extension | Author | | :-- | :-- | | [Angular module](https://github.com/avmaisak/ngx-simple-icons) Angular | [@avmaisak](https://github.com/avmaisak) | | [Blazor Nuget package](https://github.com/TimeWarpEngineering/timewarp-simple-icons) Blazor | [@TimeWarpEngineering](https://github.com/TimeWarpEngineering) | | [Blender add-on](https://github.com/mondeja/simple-icons-blender) Blender | [@mondeja](https://github.com/mondeja) | | [Drawio library](https://github.com/mondeja/simple-icons-drawio) Drawio | [@mondeja](https://github.com/mondeja) | | [Drupal module](https://www.drupal.org/project/simple_icons) Drupal | [Phil Wolstenholme](https://www.drupal.org/u/phil-wolstenholme) | | [Figma plugin](https://www.figma.com/community/plugin/1149614463603005908/Simple-Icons) Figma | [@LitoMore](https://github.com/LitoMore) | | [Flutter package](https://pub.dev/packages/simple_icons) Flutter | [@jlnrrg](https://github.com/jlnrrg) | | [Framer component](https://github.com/LitoMore/simple-icons-framer) Framer | [@LitoMore](https://github.com/LitoMore) | | [Hexo plugin](https://github.com/nidbCN/hexo-simpleIcons) Hexo | [@nidbCN](https://github.com/nidbCN/) | | [Home Assistant plugin](https://github.com/vigonotion/hass-simpleicons) Home Assistant | [@vigonotion](https://github.com/vigonotion/) | | [Hugo module](https://github.com/foo-dogsquared/hugo-mod-simple-icons) Hugo | [@foo-dogsquared](https://github.com/foo-dogsquared) | | [Java library](https://github.com/silentsoft/simpleicons4j) OpenJDK | [@silentsoft](https://github.com/silentsoft) | | [Jetpack Compose library](https://github.com/DevSrSouza/compose-icons) Jetpack Compose | [@devsrsouza](https://github.com/devsrsouza/) | | [Kirby plugin](https://github.com/runxel/kirby3-simpleicons) Kirby | [@runxel](https://github.com/runxel) | | [LaTeX package](https://github.com/ineshbose/simple-icons-latex) LaTeX | [@ineshbose](https://github.com/ineshbose) | | [Laravel package](https://github.com/ublabs/blade-simple-icons) Laravel | [@adrian-ub](https://github.com/adrian-ub) | | [Leptos crate](https://github.com/Carlosted/leptos-icons) Leptos | [@Carlosted](https://github.com/Carlosted) | | [Python package](https://github.com/sachinraja/simple-icons-py) Python | [@sachinraja](https://github.com/sachinraja) | | [React package](https://github.com/icons-pack/react-simple-icons) React | [@wootsbot](https://github.com/wootsbot) | | [Ruby gem](https://rubygems.org/gems/simple-icons-rails) Ruby | [@thepew](https://github.com/the-pew-inc) | | [Solid package](https://github.com/x64Bits/solid-icons) Solid | [@x64Bits](https://github.com/x64Bits) | | [Stream Deck icon pack](https://github.com/mackenly/simple-icons-stream-deck) Stream Deck | [@mackenly](https://github.com/mackenly) | | [Svelte package](https://github.com/icons-pack/svelte-simple-icons) Svelte | [@wootsbot](https://github.com/wootsbot) | | [Vue 3 package](https://github.com/wyatt-herkamp/vue3-simple-icons) Vue | [@wyatt-herkamp](https://github.com/wyatt-herkamp) | | [Vue package](https://github.com/mainvest/vue-simple-icons) Vue | [@noahlitvin](https://github.com/noahlitvin) | | [WordPress plugin](https://wordpress.org/plugins/simple-icons/) Wordpress | [@tjtaylo](https://github.com/tjtaylo) | ## Contribute [![Good first issues open](https://img.shields.io/github/issues/simple-icons/simple-icons/good%20first%20issue?label=good%20first%20issues&logo=git&logoColor=white)](https://github.com/simple-icons/simple-icons/labels/good%20first%20issue) Information describing how to contribute can be found in the file [CONTRIBUTING.md](https://github.com/simple-icons/simple-icons/blob/develop/CONTRIBUTING.md) [slug]: https://github.com/simple-icons/simple-icons/blob/master/slugs.md