Simple Icons

Simple Icons

Over 2500 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 Backers and sponsors on Open Collective

## Usage > **Note** We ask that all users read our [legal disclaimer](./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](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://jlnrrg.github.io/) | | [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) | | [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) | | [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