If you like control, you can host Font Awesome yourself, and you can choose to use Web Fonts + CSS described below or SVG + JS to get icons into your projects.
We’ll cover the basics of getting set up with Web Fonts and how you can use specific Font Awesome icon styles.
Set-Up with Web Fonts
Inside the Font Awesome Download or package, you'll find the files you need. The
/css folder contains the core styling and utilities for all of Font Awesome's families (Classic, Sharp, and Brands) as well as style options (Solid, Regular, Light, Duotone, and Thin). The
/webfonts folder contains all of the typeface files that the CSS files depend on.
There's a Free and Pro version of each in our Pro download - pick the one that's right for your project and grab those files.
|Which Files and Folders ||What’s in there|
|Icons as Web Fonts to be used with CSS|
|CSS files for using Web Fonts|
|Just the Free Icons as Web Fonts to be used with CSS|
|CSS files for using just the Free Web Fonts|
Add Font Awesome Files to Your Project
Copy both the
/webfonts and the
/css folders 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 styling file -
/css/fontawesome.css - as well as the CSS files for any individual styles you want to use, and you can remove any
.css and web font files you don't plan on using.
Copy webfonts and CSS assets into one of your project directories
Here's a handy table that shows which files go with which styles:
Reference Font Awesome in Your Project
Link the core
fontawesome.css file along with the CSS files for whichever styles you want to use into the
<head> of each template or page that you plan to add icons to. Make sure the paths correctly point to where you placed the files!
Here's an example html page with the file links in the Just this once, we recommend letting things go to your head.
<head> and a couple of icons in the content.
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.css
/css folder, you may have noticed a file named
all.css. 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.css file - you'll need to add the Sharp
.css 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 and files isn't great for performance.
If you'd like to use the
all.css, just copy the
/webfonts folder and the
/css/all.css file into your project’s assets directory where other images and CSS are stored. You'll want to keep them in the same directory.
Then, add a link to the
/your-path-to-fontawesome/css/all.css file into the
<head> of each template or page where you want to use Font Awesome.
Hosting Your Own Downloaded Kit
If you'd rather do the heavy lifting, you can download any Pro Kit and host it yourself! To download your Kit, make sure it's a Pro with the version in Settings is set to "Latest 6.x" or at least 6.4. Then from the Set Up tab in your Kit, you'll see the options for downloading.
Custom Icons in Downloaded Kits
If you have custom icons in your Kit, they will be included in your Kit download. You'll find these additional files included in the download zip:
|Path to the files ||What the files do|
|Handles the display of custom icons with Web Fonts|
|Handles the display of custom icons with SVG+JS|
|All your custom icons in one SVG sprite|
|Folder containing all your custom icons as SVGs|
|Custom icon font in WOFF2 and TTF formats|
|Sass (SCSS) and Less Preprocessor partials that handle the display of custom icons with Web Fonts|
These files will work the same as the Font Awesome files and assets. And if you are using
all.css, your custom icons will be included in those, though for performance reasons, we recommend adding just the files you are using in your project.
Here's an example project using Sharp Solid and custom icons from a downloaded Kit: Using Kit custom icons is easy peasy.
Older Version Compatibility
If your project is using an older version of Font Awesome, we've got you covered with backward compatibility. 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
If you're hosting yourself and using only certain styles, add the
css/v5-font-face.css to the files linked in your html
all.css file includes these utilities by default so you won't need to do anything.)
Here's an example:
Version 4 Compatibility
If your project contains Font Awesome 4 icon references, add the
css/v4-font-face.css to the files linked in your html
head. Our CSS will then translate any Font Awesome 4 icon names and CSS pseudo-elements references to Version 6 automatically.
If you're using
all.css, you'll need to add the
v4-shims.js file, which will map V4 icon names to icons in the latest version of Font Awesome, like this:
If you need more help upgrading an existing project to a newer version of Font Awesome, check out our upgrading guides.