Skip to content

Simple Icons

Simple Icons is a library of over 3,000 icons for popular brands.

Usage

  1. Find the icon you want
  2. Pass its name to icons.simple (1)

  1. icons.si works, too.

    import RIL as icons

icons.si("simple icons")

import RIL as icons

icons.simple("simple icons")

There's just one unintuitive exception

The icon, identified by Simple Icons as "/e/", is passed as simply "e". 

import RIL as icons

icons.simple("e")

Icon names are case-inensitive.

Props

Name Type Description
title str A short, accessible, title for the icon.
color str | tuple The color of the icon. May be a hex code, a tuple of RGB, RGBA, or HSL values, or any valid CSS Color Module Level 3 color name. It may also be "default", in which case the icon will use the color it has been assigned by Simple Icons.
size int | str The size of the icon. May be an integer (in pixels) or a CSS size string (e.g., "1rem").
version int | "latest" The major version of Simple Icons to use for this icon. May be "latest" or an integer greater than or equal to 10. Defaults to the value of the simple.version setting.

Versioning

In addition to setting a version per-icon via the version prop, RIL also allows you to set a default Simple Icons version via the simple.version setting.

simple.version: Controls the major version of Simple Icons used by RIL.

simple.version is the highest major version of Simple Icons that RIL may use (or latest). RIL will use the newest version of Simple Icons available within this constraint.

If this is an integer, it must be greater than or equal to 10. Defaults to latest.

[tool.ril.simple]
version = 13

[simple]
version = 13

RIL_SIMPLE__VERSION=13