How To Add Icons
You can place Font Awesome icons just about anywhere, and we've tried to make it so that icons will take on the characteristics and blend in with surrounding text naturally.
We'll cover the basics of how to add icons to your project, shorthand class names for different icon styles, how to add icons to HTML, using icons aliases, and more!
Before You Get Started
Make sure you've:
Set up Font Awesome in your project and know where you parked your tardis.
Basics
To add an icon, you need to know a few bits of information:
- The shorthand class name for the style you want to use
- The icon name, prefixed with
fa-(meaning "Font Awesome" naturally!) - The shorthand class name for the family you want to use (the default is the Classic family if you don't include a family class)
So to add an icon to your HTML, you just add an element with that classes to your page. Here's an example:
<i class="fa-sharp fa-solid fa-user"></i> <!-- In the example above, you add... 1. `fa-solid` class for Solid style 2. `user` icon with the `fa-` prefix 3. `fa-sharp` class for Sharp family ... and you'll see the Sharp Solid User icon -->
We designed Font Awesome for use with inline elements, and we recommend that you stick with a consistent element in your project. We recommend using <i> element and you'll add CSS classes for the for the Font Awesome family and style of icon you want to use and the icon name class with the fa- prefix for the icon you want to use.
If you want to avoid using the i tag, you can use a <span> element instead of <i>. Here's that same example using a span tag:
<!-- You can use a <span> element, with classes applied in the same way --> <span class="fa-sharp fa-solid fa-user"></span>
Leave 'fa-' to Font Awesome
We don't recommend creating your own classes that start with fa- as it can result in missing icons or other unwanted behavior. You can add any other custom classes to your elements though!
Families + Styles
Font Awesome contains many icon packs each with its own visual look and collection of families and styles. Below you'll find all our families and styles listed with the classes and other info you need to add icons to your projects.
Classic
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Free or Pro | fa-solid |
Font Awesome 7 FreeFont Awesome 7 Pro |
900 |
|
| Regular | Free or Pro | fa-regular |
Font Awesome 7 FreeFont Awesome 7 Pro |
400 |
|
| Light | Pro only | fa-light |
Font Awesome 7 Pro |
300 |
|
| Thin | Pro only | fa-thin |
Font Awesome 7 Pro |
100 |
Font Awesome Classic is Our Default Family
If you don't specify a family class name, our styling toolkit will render icons in Font Awesome Classic, the original look and feel that's always in style. But if you need to reference the Classic family, you can just add the fa-classic in your icon's HTML class names. If you want to change any or all icons to use Sharp, just add fa-sharp in the same manner!
Duotone
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Pro only | fa-duotone fa-solid |
Font Awesome 7 Duotone |
900 |
|
| Regular | Pro only | fa-duotone fa-regular |
Font Awesome 7 Duotone |
400 |
|
| Light | Pro only | fa-duotone fa-light |
Font Awesome 7 Duotone |
300 |
|
| Thin | Pro only | fa-duotone fa-thin |
Font Awesome 7 Duotone |
100 |
Sharp
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Pro only | fa-sharp fa-solid |
Font Awesome 7 Sharp |
900 |
|
| Regular | Pro only | fa-sharp fa-regular |
Font Awesome 7 Sharp |
400 |
|
| Light | Pro only | fa-sharp fa-light |
Font Awesome 7 Sharp |
300 |
|
| Thin | Pro only | fa-sharp fa-thin |
Font Awesome 7 Sharp |
100 |
Sharp Duotone
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Pro only | fa-sharp-duotone fa-solid |
Font Awesome 7 Sharp Duotone |
900 |
|
| Regular | Pro only | fa-sharp-duotone fa-regular |
Font Awesome 7 Sharp Duotone |
400 |
|
| Light | Pro only | fa-sharp-duotone fa-light |
Font Awesome 7 Sharp Duotone |
300 |
|
| Thin | Pro only | fa-sharp-duotone fa-thin |
Font Awesome 7 Sharp Duotone |
100 |
Brands
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Brands | Free | fa-brands |
Font Awesome 7 Brands |
400 |
Chisel
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Regular | Pro+ only | fa-chisel fa-regular |
Font Awesome 7 Chisel |
400 |
Etch
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Pro+ only | fa-etch fa-solid |
Font Awesome 7 Etch |
900 |
Jelly
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Regular | Pro+ only | fa-jelly fa-regular |
Font Awesome 7 Jelly |
400 |
|
| Fill Regular | Pro+ only | fa-jelly-fill fa-regular |
Font Awesome 7 Jelly Fill |
400 |
|
| Duo Regular | Pro+ only | fa-jelly-duo fa-regular |
Font Awesome 7 Jelly Duo |
400 |
Notdog
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Solid | Pro+ only | fa-notdog fa-solid |
Font Awesome 7 Notdog |
900 |
|
| Duo Solid | Pro+ only | fa-notdog-duo fa-solid |
Font Awesome 7 Notdog Duo |
900 |
Slab
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Regular | Pro+ only | fa-slab fa-regular |
Font Awesome 7 Slab |
400 |
|
| Press Regular | Pro+ only | fa-slab-press fa-regular |
Font Awesome 7 Slab Press |
400 |
Thumbprint
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Light | Pro+ only | fa-thumbprint fa-light |
Font Awesome 7 Thumbprint |
300 |
Utility
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Semibold | Pro+ only | fa-utility fa-semibold |
Font Awesome 7 Utility |
600 |
|
| Fill Semibold | Pro+ only | fa-utility-fill fa-semibold |
Font Awesome 7 Utility Fill |
600 |
|
| Duo Semibold | Pro+ only | fa-utility-duo fa-semibold |
Font Awesome 7 Utility Duo |
600 |
Whiteboard
| Style | Availability | Classes | font-family | font-weight | Preview |
|---|---|---|---|---|---|
| Semibold | Pro+ only | fa-whiteboard fa-semibold |
Font Awesome 7 Whiteboard |
600 |
Parity Across Icon Packs
Each Pro+ only style is considered "small batch" and does not have parity with categories or icons in our larger Packs. Instead they contain a curated selection of the 200 most common icons needed for app and website design.
Kit-Based Custom Icons
If you're using a Font Awesome Kit and have added custom icons.
| Style | Availability | Classes | font-family | font-weight |
|---|---|---|---|---|
| Custom Icons | Pro Kits only | fa-kit |
Font Awesome Kit |
400 |
| Custom Duotone Icons | Pro Kits only | fa-kit-duotone |
Font Awesome Kit Duotone |
400 |
Setting Different Families + Styles
Here are some examples that show different styles and families of icons:
<!-- icon rendered across the Classic family (Classic is set by default) --> <i class="fa-solid fa-user"></i> <i class="fa-regular fa-user"></i> <i class="fa-light fa-user"></i> <i class="fa-thin fa-user"></i> <!-- icon rendered across the Classic family (Classic is set explicitly) --> <i class="fa-classic fa-solid fa-user"></i> <i class="fa-classic fa-regular fa-user"></i> <i class="fa-classic fa-light fa-user"></i> <i class="fa-classic fa-thin fa-user"></i> <!-- icon rendered across the Duotone family --> <i class="fa-duotone fa-solid fa-user"></i> <i class="fa-duotone fa-regular fa-user"></i> <i class="fa-duotone fa-light fa-user"></i> <i class="fa-duotone fa-thin fa-user"></i> <!-- icon rendered across the Sharp family --> <i class="fa-sharp fa-solid fa-user"></i> <i class="fa-sharp fa-regular fa-user"></i> <i class="fa-sharp fa-light fa-user"></i> <i class="fa-sharp fa-thin fa-user"></i> <!-- icon rendered across the Sharp Duotone family --> <i class="fa-sharp-duotone fa-solid fa-user"></i> <i class="fa-sharp-duotone fa-regular fa-user"></i> <i class="fa-sharp-duotone fa-light fa-user"></i> <i class="fa-sharp-duotone fa-thin fa-user"></i> <!-- icon rendered across Small Batch families --> <i class="fa-chisel fa-regular fa-user"></i> <i class="fa-etch fa-solid fa-user"></i> <i class="fa-jelly fa-regular fa-user"></i> <i class="fa-jelly-fill fa-regular fa-user"></i> <i class="fa-jelly-duo fa-regular fa-user"></i> <i class="fa-notdog fa-solid fa-user"></i> <i class="fa-notdog-duo fa-solid fa-user"></i> <i class="fa-slab fa-regular fa-user"></i> <i class="fa-slab-press fa-regular fa-user"></i> <i class="fa-thumbprint fa-light fa-user"></i> <i class="fa-whiteboard fa-semibold fa-user"></i> <!-- Font Awesome Brands icon --> <i class="fa-brands fa-font-awesome"></i>
Stay on target with those CSS rules!
When using our SVG framework, remember that DOM elements with Font Awesome classes are replaced with injected <svg> elements by default. Be sure that your CSS rules target the right element.
Aliases
Since v6, we've updated many of our icon names to make them more universal and consistent. But if you're a v5 or earlier user, we wanted to make sure not to break your existing code. So we made aliases for renamed icons to allow them to work with either the old or new names.
And you can use the old or new name for styles as well. So you can still use fas, far, fal, fad, and fab. And we've also included older prefix versions for our new Thin style (fat) and new Sharp family of styles (Sharp Solid is fass while Sharp Regular is fasr).
<!-- All of these code snippets will render the same Solid icon thanks to aliases. --> <i class="fa-solid fa-cutlery"></i> <i class="fa-solid fa-utensils"></i> <i class="fas fa-utensils"></i> <!-- All of these code snippets will render the same Sharp Solid icon thanks to aliases. --> <i class="fa-sharp fa-solid fa-times"></i> <i class="fa-sharp fa-solid fa-close"></i> <i class="fass fa-xmark"></i>
Alternate Ways to Add Icons
We also have many other ways to add Font Awesome icons, in case your situation calls for something specific:
When using Web Fonts
When using SVGs
- Use SVGs without JS using our SVG Sprites
- Bring-Your-Own style with our bare SVGs
- Use SVG symbols to improve performance with repeating icons
- Use an Icon's Unicode value
- Use an Icon's name
In Other Integrations
- In Vue
- In React
- In WordPress
- In Squarespace
- With SCSS
- ... and more! Check out the Integrations section for all the options.