Font Awesome¶

Font Awesome is a library of over 50,000¹ icons in several different styles, including over 400 icons for popular brands.

Usage¶

Font Awesome icons can be used via icons.fontawesome or icons.fa. There's no functional difference between the two, but the latter is shorter, so it is preferred and is what will be used throughout the rest of the documentation.

Each of Font Awesome's styles is available as a method of icons.fa. To use an icon, pass its name to the method of your desired style.

Classic Sharp Duotone Sharp Duotone Brands Icon Packs Custom Icons

import RIL as icons

icons.fa.solid("house") 
icons.fa.regular("magnifying-glass") 
icons.fa.light("user")
icons.fa.thin("check")

import RIL as icons

icons.fa.sharp.solid("download")  
icons.fa.sharp.regular("image")  
icons.fa.sharp.light("phone")  
icons.fa.sharp.thin("bars")

import RIL as icons

icons.fa.duotone.solid("envelope") 
icons.fa.duotone.regular("wand-magic-sparkles") 
icons.fa.duotone.light("bomb")  
icons.fa.duotone.thin("camera-retro")

import RIL as icons

icons.fa.sharp_duotone.solid("music")  
icons.fa.sharp_duotone.regular("comment")  
icons.fa.sharp_duotone.light("hippo") 
icons.fa.sharp_duotone.thin("calendar-days")

import RIL as icons

icons.fa.brands("python")

Info

These styles require a Font Awesome Pro+ subscription and a Kit.

ChiselEtchJellyNotdogSlabThumbprintWhiteboardUtility

import RIL as icons

icons.fa.chisel("house")

import RIL as icons

icons.fa.etch("house")

import RIL as icons

icons.fa.jelly("house")
icons.fa.jelly.fill("circle-user")
icons.fa.jelly.duo("image")

import RIL as icons

icons.fa.notdog("house")
icons.fa.notdog.duo("circle-user")

import RIL as icons

icons.fa.slab("house")
icons.fa.slab.press("circle-user")

import RIL as icons

icons.fa.thumbprint("house")

import RIL as icons

icons.fa.whiteboard("house")

import RIL as icons

icons.fa.utility("house")
icons.fa.utility.fill("circle-user")
icons.fa.utility.duo("image")

See Using a Kit for setup instructions.

import RIL as icons

icons.fa.kit("my-custom-icon")

The Classic Solid, Classic Regular, and Brands styles are available for free²; other styles require Font Awesome Pro.

Tip

Classic Solid is the component's default style and can also be used by calling icons.fa directly:

import RIL as icons

icons.fa("house")  # equivalent to icons.fa.solid("house")

Solid is also the default substyle for Sharp, Duotone, and Sharp Duotone:

import RIL as icons

icons.fa.sharp("download")  # equivalent to icons.fa.sharp.solid("download")
icons.fa.duotone("envelope")  # equivalent to icons.fa.duotone.solid("envelope")
icons.fa.sharp_duotone("music")  # equivalent to icons.fa.sharp_duotone.solid("music")

Only just over 2,000 icons are free, though. The rest require Font Awesome Pro. ↩
Even within the Classic Solid and Classic Regular styles, some individual icons require Font Awesome Pro. The Brands style is completely free. ↩