Whether you’re a FA n00b or an old pro, we've worked hard to make upgrading to Version 6 as smooth and easy as possible. Learn more about what's changed and how to update your project.
What's new about Version 6?
We've packed a lot into Font Awesome 6 including: Jump into the Deets on Version 6 Changes
Upgrade from Version 5 When Using a Kit
If you're using a Kit, upgrading to Version 6 should be
- Head to your Kit's settings.
- Select Version 6 from the "Versions" menu.
- Save that settings change.
- Grab yourself a coffee with all that time you just saved.
Upgrade Your Kit
Upgrade from Version 5 When Self-Hosting
If you are currently hosting Font Awesome 5 yourself or installed Font Awesome using a package, you'll need to swap out and disconnect the old Version 5 files, then place and hook up the new Version 6 files in your project.
1. Locate and remove Any Version 5 Files From Your Project
Loading two different versions of Font Awesome may cause conflicts, so you’ll need to find the location of the old files and remove them.
Finding the location of the Version 5 files depends on how you installed Font Awesome. Here are a couple of examples of possible project set-ups:
You can safely delete any of old version files since you'll be replacing them with the new Version 6 files in the next step.
2. Download and Install Version 6
Next, download Version 6 and unpack the files and icons, or update your Font Awesome packages/components to Version 6, depending on what works best for your project.
Download and place into your project:
Or Update Packages and Components:
3. Update Version 5 References to Point to Version 6 Files
You've removed the old Version 5 icons and files and added in the new Version 6 icons and files, and now you need to update your old Version 5 references to point to the new Version assets you've added.
For projects with HTML templates, you'll need to edit the script or CSS links in the
head of your templates. If you used
all.css, we recommend switching to individual styles to improve performance if that's an option for you.
Here is an example of adding the Version 6 SVG + JS files:
And here is an example of adding the Version 6 Web Fonts + CSS files:
You can also update the
all.css file, though we recommend switching to using individual styles if possible to improve performance:
If You're Unable to Remove Font Awesome 5
If you can't remove a previous version of Font Awesome from your project (e.g. it's bundled in a theme or plugin you're using), it's important to make sure that you include the v6 files after those previous versions are included in the
<head> of your project's HTML. This is extra important when including the
Upgrade from Version 4
Need to upgrade from Version 4 to Version 6? We've written a custom guide just for you. Check out the v4 upgrading instructions here.