Add Icons

After finding an icon you want to use in a project, here's how to place it on the web, desktop, and elsewhere.

First Things First!

Make sure you’ve set up Font Awesome in your project and are ready to manage some mischief.

# Basics

You can place Font Awesome icons just about anywhere. We've tried to make it so that icons will take on the characteristics and blend in with surrounding text naturally. To add an icon, you need to know two bits of information:

  1. the shorthand class name for the style you want to use
  2. the icon name, prefixed with fa- (meaning “font awesome” naturally!)
Style Availability Style class @font-face weight Looks like
Solid Free Plan fa-solid 900
Regular Pro Plans only fa-regular 400
Thin Pro Plans only fa-thin 100
Light Pro Plans only fa-light 300
Duotone Pro Plans only fa-duotone 900
Brands Free Plan fa-brands 400

# Aliases

We've updated many of our icon names in version 6 to adhere to our new naming conventions. We wanted to make sure not to break your existing code so we made aliases for renamed icons that will allow them to work with either the old or new names.

<!-- Both of these code snippets will render the same icon. -->
<i class="fa-solid fa-cutlery"></i>
<i class="fa-solid fa-utensils"></i>

Mind the (Alpha) Gap!

Aliases are only available with Web Fonts at this time. Aliases for SVG will be included in an upcoming alpha release.

# Add Icons to HTML (Web Fonts and SVG)

Font Awesome is designed to be used with inline elements and we recommend sticking with a consistent element in your project. We prefer using i element with added Font Awesome classes: 1) style class and 2) icon name with the fa- prefix.

<!-- This example uses <i> element with: 
1. the `fa-solid` style class for solid style
2. the `user` icon with the fa- prefix -->
<i class="fa-solid fa-user"></i> 

<!-- Or you can use a <span> element, with classes applied in the same way -->
<span class="fa-solid fa-user"></span> 

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.

# Add Icons on the Desktop

When working in desktop applications, like Adobe Illustrator, Figma, and Sketch, you can use Font Awesome as a typeface in any text area. We have ligatures for each and every icon so you can type in the name of the icon you want and it will magically appear.

  1. Create a text area in the application you're working in.
  2. Set the Font/Typeface to "Font Awesome 6" (or "Font Awesome 6 brands" for brands).
  3. Type the icon's name into the text area (without the "fa-" prefix, i.e. "camera").
  4. Change the font weight to switch between styles.

A No-Go for Duotone

There is not a ligature-based desktop font available for Duotone icons at the moment. This is because they are made of two glyphs, which current font technology can't support. You'll need to add those by placing SVG files into your designs.


# Alternate Ways to Add Icons

We also have a number of other ways to add Font Awesome icons, in case your situation calls for something specific:

# When using Web Fonts:

# When using SVGs:

# On the Desktop:

Something on your mind? We're all ears!

New icons just what you wanted? New thin style all that? Docs missing something key? Drop us a line and tell us all the good, bad and the ugly so we can make it even more awesome.

Manufacturers Protocol dictates this alpha cannot be captured. It must self-destruct.