simple-icons

Simple Icons

Over 3100 Free 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 before using icons from Simple Icons.

General Usage

Icons can be downloaded as SVGs directly from our website - 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 or Unpkg. Simply use the simple-icons npm package and specify a version in the URL like the following:

<img src="https://cdn.jsdelivr.net/npm/simple-icons@v11/icons/[ICON SLUG].svg" width="32" height="32">
<img src="https://unpkg.com/simple-icons@v11/icons/[ICON SLUG].svg" width="32" height="32">

Where [ICON SLUG] is replaced by the slug of the icon you want to use, for example:

<img src="https://cdn.jsdelivr.net/npm/simple-icons@v11/icons/simpleicons.svg" width="32" height="32">
<img src="https://unpkg.com/simple-icons@v11/icons/simpleicons.svg" width="32" height="32">

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.

<img src="https://cdn.simpleicons.org/[ICON SLUG]" width="32" height="32">
<img src="https://cdn.simpleicons.org/[ICON SLUG]/[COLOR]" width="32" height="32">
<img src="https://cdn.simpleicons.org/[ICON SLUG]/[COLOR]/[DARK_MODE_COLOR]" width="32" height="32">

Where [COLOR] is optional, and can be replaced by the hex colors or CSS 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. [DARK_MODE_COLOR] is used for dark mode. The CSS prefers-color-scheme will be used when a value is specified. For example:

<img src="https://cdn.simpleicons.org/simpleicons" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/gray" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/hotpink" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/0cf" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/0cf9" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/00ccff" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/00ccff99" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/orange/pink" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/_/eee" width="32" height="32">
<img src="https://cdn.simpleicons.org/simpleicons/eee/_" width="32" height="32">

Node Usage

The icons are also available through our npm package. To install, simply run:

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 to remove the unused icon code:

// 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:

console.log(siSimpleicons);

/*
{
    title: 'Simple Icons',
    slug: 'simpleicons',
    hex: '111111',
    source: 'https://simpleicons.org/',
    svg: '<svg xmlns="https://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img">...</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:

import * as icons from 'simple-icons';

TypeScript Usage

Type definitions are bundled with the package.

import type { SimpleIcon } from 'simple-icons';

PHP Usage

The icons are also available through our Packagist package. To install, simply run:

composer require simple-icons/simple-icons

The package can then be used as follows, where [ICON SLUG] is replaced by a slug:

...
?>

Third-Party Extensions

Extension	Author	License	Simple Icons Version
Angular module	@avmaisak
Blazor Nuget package	@TimeWarpEngineering
Blender add-on	@mondeja
Drawio library	@mondeja
Drupal module	Phil Wolstenholme
Figma plugin	@LitoMore
Flutter package	@jlnrrg
Framer component	@LitoMore
Hexo plugin	@nidbCN
Home Assistant plugin	@vigonotion
Hugo module	@foo-dogsquared
Java library	@silentsoft
Jetpack Compose library	@DevSrSouza
Kirby plugin	@runxel
LaTeX package	@ineshbose
Laravel package	@adrian-ub
Leptos crate	@Carlosted
Python package	@sachinraja
Raycast extension	@LitoMore
React package	@wootsbot
Ruby gem	@thepew
Solid package	@x64Bits
Stream Deck icon pack	@mackenly
Svelte package	@wootsbot
Vue 3 package	@wyatt-herkamp
Vue package	@noahlitvin
Webflow app	@diegoliv
WordPress plugin	@tjtaylo

> Important
> From our next scheduled major release (v12, releasing on May 26, 2024), we will begin removing third-party extensions from the above list that are not up to date with at least our previous major release.
> For example, when v12 is released, we will remove any extensions that don't support v11.0.0 or higher.
> Please create a PR to update the version number of your extension in this README following each update of your extension.

Contribute

Information describing how to contribute can be found in the file CONTRIBUTING.md

Contributors