Don't Miss Out! To celebrate the release of Font Awesome Sharp, get $20 off a new Pro subscription for a limited time!

If you like control, you can host Font Awesome yourself, and you can choose to use SVG + JS described below or Web Fonts + CSS to get icons into your projects.

Advertisement

Before You Get Started

Make sure you:

Set up with SVG+JS

Inside the Font Awesome Download or package, you'll find the files you need. The /js folder contains the core styling, utilities, and icons for all of Font Awesome's families (Classic, Sharp, and Brands) as well as style options (Solid, Regular, Light, Duotone, and Thin).

There's a Free and Pro folder in our Pro download - pick the one that's right for your project and grab the files from there.

Which Files and Folders What’s in there
/fontawesome6/pro/js Icons and scripts for each style, or all of them at once.
/fontawesome6/free/js Just the Free icons and scripts for each style.

Add Font Awesome Files to Your Project

Copy both the fontawesome.js loader and the .js files for the styles you'd like to use into your project's static assets directory (or wherever you prefer to keep front end assets or vendor stuff). Be sure to include the core file - /js/fontawesome.js - as well as the JS files for any individual styles you want to use.

Copy the core and specific style files you need into your project directories

Copy the core and specific style files you need into your project directories
Advertisement

Here's a handy table that shows which file goes with which style:

Icon Style Availability JS Filename
Brands Free brands.js or brands-min.js
Solid Free solid.js or solid-min.js
Regular Pro only regular.js or regular-min.js
Light Pro only light.js or light-min.js
Thin Pro only thin.js or thin-min.js
Duotone Pro only duotone.js or duotone-min.js
Sharp Solid Pro only sharp-solid.js or sharp-solid-min.js

Font Awesome Sharp requires v6.2.0!

Make sure you have an active Pro-level plan or a Pro license with access to Font Awesome v6.2.0 or greater in order to use our Sharp Solid icons.

Reference Font Awesome in Your Project

Link the core fontawesome.js file along with the JS files for whichever styles you want to use into the <head> of each template or page that you plan to add icons to. We recommend referencing the fontawesome.js loader last. Make sure the paths correctly point to where you placed the files!

Here's an example html page with the file links in the <head> and a couple of icons in the content.

<head>
  <!-- Our project just needs Font Awesome Solid + Brands -->
  <script defer src="/your-path-to-fontawesome/js/brands.js"></script>
  <script defer src="/your-path-to-fontawesome/js/solid.js"></script>
  <script defer src="/your-path-to-fontawesome/js/fontawesome.js"></script>
</head>
<body>
  <i class="fa-solid fa-user"></i>
  <!-- uses solid style -->
  <i class="fa-brands fa-github-square"></i>
  <!-- uses brand style -->
</body>
Just this once, we recommend letting things go to your head.

Double-Check Your Paths

Make sure the paths of the files you've included in your pages' <head> point to where you've moved all of Font Awesome's files in your project.

Yuss! You’re Ready to Add Icons

Like Anakin said, it’s woooorking! All of our icons are now ready to do your project’s bidding. Learn how to add them to your project and then use their power to bring order and style to your UI!

Add Some Icons!

Alternate Install: Using all.js

In the /js folder, you may have noticed a file named all.js. This file contains the core styling and utilities PLUS all of the icons in all the Classic styles in Font Awesome. (The Sharp family is not included in the all.js file - you'll need to the Sharp .js files separately.)

It's a handy file if you'll be using all the icon styles or testing out different styles as you develop your project. But if you're using just a couple of styles, we don't recommend it for production sites since loading all of the icons isn't great for performance.

If you'd like to use the all.js, just copy it into your project’s static assets directory, or wherever you prefer to keep front-end assets or vendor stuff.

Then, add a link to the /your-path-to-fontawesome/js/all.js file into the <head> of each template or page where you want to use Font Awesome icons.

Advertisement

Older Version Compatibility

If your project is using an older version of Font Awesome, we've got you covered with backward compatiiblity. That means you won't have to update any icon names in your project - we'll translate any older version icon names, style syntax, and CSS pseudo-element icon references automatically. Here's how to enable that support for the previous version you need to support:

Version 5 Compatibility

Once loaded, our SVG + JS framework handles translating any Font Awesome 5 icon names, style syntax, and CSS pseudo-element icon references automatically. This is true when using the js/all.js file or using only certain styles.

Version 4 Compatibility

If your project contains Font Awesome 4 icon references, add the v4-shims.js file after any v6 JS files you're including. That file will map v4 icon names to icons in the latest version of Font Awesome.

Here's an example:

<head>
  <!-- Add the v6 core styles and then select the individual styles you need, like Solid and Brands -->
  <script defer src="/your-path-to-fontawesome/js/fontawesome.js"></script>
  <script defer src="/your-path-to-fontawesome/js/solid.js"></script>
  <script defer src="/your-path-to-fontawesome/js/brands.js"></script>

  <!-- support v4 icon references/syntax -->
  <script defer src="/your-path-to-fontawesome/js/v4-shims.js"></script>
</head>

If you need more help upgrading an existing project to a newer version of Font Awesome, check out our upgrading guides.