Over 3300 SVG icons for popular brands. See them all on one page at SimpleIcons.org. Contributions, corrections & requests can be made on GitHub.
## Usage
> **Important**\
> 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 [simpleicons.org](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 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
```
You can use a `viewbox=auto` parameter to get an auto-sized viewbox. This is useful if you want all icons rendered with consistent size:
```html
```
### Node Usage
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
Type definitions are bundled with the package.
```typescript
import type {SimpleIcon} from 'simple-icons';
```
### PHP Usage
The icons are also available through [our Packagist package](https://packagist.org/packages/simple-icons/simple-icons). 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
...
?>
```
### Font Usage
See [simple-icons-font](https://github.com/simple-icons/simple-icons-font) to learn how to use our font distribution.
## Third-Party Extensions
The below are known extensions to third-party tools.
| Extension | Author |
| :-- | :-- |
| Blender add-on | [@mondeja](https://github.com/mondeja) |
| Boxy SVG library | [@Jarek](https://boxy-svg.com/profiles/0000000000/jarek) |
| Drawio library | [@mondeja](https://github.com/mondeja) |
| Figma plugin | [@LitoMore](https://github.com/LitoMore) |
| Jekyll plugin | [@pirafrank](https://github.com/pirafrank) |
| Kando icon theme | [@Schneegans](https://github.com/Schneegans) |
| Miro app | [@LitoMore](https://github.com/LitoMore) |
| Raycast extension | [@LitoMore](https://github.com/LitoMore) |
| Stream Deck icon pack | [@mackenly](https://github.com/mackenly) |
| Typst package | [@cscnk52](https://github.com/cscnk52) |
| Webflow app | [@diegoliv](https://github.com/diegoliv) |
Maintain an extension? [Submit a PR][open-pr] to include it in the list above.
## Third-Party Libraries
The below are known third-party libraries for use in your own projects. We only keep items in the list that are at least up to date with our previous major version.
| Library | Author | License | Simple Icons |
| :-- | :-- | :-: | :-: |
| Angular package | [@gridatek](https://github.com/gridatek) |  |  |
| Astro package | [@Aviortheking](https://github.com/aviortheking) |  |  |
| Blazor Nuget package | [@TimeWarpEngineering](https://github.com/TimeWarpEngineering) |  |  |
| Flutter package | [@jlnrrg](https://github.com/jlnrrg) |  |  |
| Framer component | [@LitoMore](https://github.com/LitoMore) |  |  |
| Hugo module | [@foo-dogsquared](https://github.com/foo-dogsquared) |  |  |
| Java library | [@silentsoft](https://github.com/silentsoft) |  |  |
| Kirby plugin | [@runxel](https://github.com/runxel) |  |  |
| LaTeX package | [@ineshbose](https://github.com/ineshbose) |  |  |
| Laravel package | [@adrian-ub](https://github.com/adrian-ub) |  |  |
| Python wheel | [@carstencodes](https://github.com/carstencodes) |  |  |
| React package | [@wootsbot](https://github.com/wootsbot) |  |  |
| Ruby gem | [@thepew](https://github.com/the-pew-inc) |  |  |
| Rust crate | [@cscnk52](https://github.com/cscnk52) |  |  |
| Svelte package | [@wootsbot](https://github.com/wootsbot) |  |  |
| Vue 3 package | [@wyatt-herkamp](https://github.com/wyatt-herkamp) |  |  |
Maintain a library? [Submit a PR][open-pr] to include it in the list above.
## Contribute
[](https://github.com/simple-icons/simple-icons/issues?q=is%3Aopen+label%3A%22good+first+issue%22+-linked%3Apr) [](https://github.com/simple-icons/simple-icons/issues?q=is%3Aissue+is%3Aopen+label%3A%22new+icon%22%2C%22update+icon%2Fdata%22) [](https://github.com/simple-icons/simple-icons/issues?q=is%3Aissue+is%3Aopen+label%3Adocs%2Cmeta%2Cpackage+-linked%3Apr) [](https://github.com/simple-icons/simple-icons/issues?q=is%3Aopen+is%3Aissue+label%3Adocs+-linked%3Apr)
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
[open-pr]: https://github.com/simple-icons/simple-icons/compare
## Contributors