- Use Font Awesome on the Web
- Remove ads with a Pro plan!
- And of course Pro-level plans come with…
- Setting Up on the Web
- Use a Kit
- In a Hurry? Try Our Quick Start.
- Host Yourself
- Upgrade from Earlier Versions of Font Awesome
- Use Font Awesome npm Packages
- Add Font Awesome Icons to Your Project
- Remove ads with a Pro plan!
- And of course Pro-level plans come with…
- Get Started
- Icons on your site. Fast.
- Super-simple upgrades
- Auto accessibility support
- Async your icons
- Download & Customize Easy
- Using CSS
- Using Sass or Less
- Advanced & Packages Pro
- Less Ruby Gem
- Sass Ruby Gem
- More Information
- Validators
- Internet Explorer 8 and @font-face
- Need IE7 Support?
- Troubleshooting
- Help & Support
- Why should I use a CDN?
- How do I use Font Awesome via CDN on my site?
- Create an Embed Code
- Add that Embed Code to Your Project
- Drop any of the 600+ icons in
- Here’s an abbreviated example of a page that’s using Font Awesome CDN
- What do you mean by Auto Accessibility?
- Using Icons are Decorative Elements
- Using Icons for Semantic or Interactive Purposes
- For icons that are decorative
- For icons that have semantic or interative meaning
- What are asynchronously loading icons?
- Account Access
- My icons aren’t rendering correctly
- Make sure you’ve set things up properly
- Make sure you’re not using another version or copy of Font Awesome
- Double-check your icon markup
- Double-check your CSS
- Ask the community
- Still perplexed?
- Font Awesome isn’t loading on my pages
- Make sure you’ve set things up properly
- Triple-check that you’ve referenced your embed code
- Ask the community
- Still have a boggle?
- Find a Bug or Issue?
- Questions & Feedback
Use Font Awesome on the Web
Get set up, add icons and style, or fine-tune – we’ve got what you need to know to use Font Awesome icons on the web.
Remove ads with a Pro plan!
A subscription to a Pro-level plan will remove all third-party advertisements on fontawesome.com.
And of course Pro-level plans come with…
Get Font Awesome Pro for only $99/yr
Setting Up on the Web
There are a few different ways to set up Font Awesome. We suggest using a kit since it’s easy, fast, and customizable.
Use a Kit
Like a CDN just for you! Adjust the settings, get auto-subsetting, upload your own icons, and lots more goodies.
In a Hurry? Try Our Quick Start.
Create a kit, add some icons, sprinkle in some style, and you’re off and running!
Host Yourself
Take the wheel and drive how you want when you host yourself.
Upgrade from Earlier Versions of Font Awesome
Are you a Font Awesome OG using Version 5, or even 4? You can easily upgrade to Version 6.
Use Font Awesome npm Packages
Get all the awesome packed up to-go in our npm packages.
Add Font Awesome Icons to Your Project
Remove ads with a Pro plan!
A subscription to a Pro-level plan will remove all third-party advertisements on fontawesome.com.
And of course Pro-level plans come with…
Get Font Awesome Pro for only $99/yr
You can add icons to your web projects with a little bit of code — it’s easy once you have a few of the basics under your belt.
Get Started
Font Awesome CDN is the easiest way to get Font Awesome on your website or app, all with just a single line of code. No downloading or installing!
We create new embed codes for each website so you can quickly upgrade and change your preferences all without ever pushing code. To do this, we need an email address so we know which embed codes are yours and so you can come back and manage them.
Icons on your site. Fast.
Don’t mess with files locally or in production. You’ll get all of Font Awesome’s 675 icons plus CSS toolkit — all optimized for speed and no hassle.
Super-simple upgrades
Since each site gets a unique embed code, you can easily upgrade to the latest version of Font Awesome, all without pushing any code. Easy peasy.
Auto accessibility support
Font Awesome CDN helps you automate accessibility support more easily so your icons work for the most people possible. Read up on our accessibility best practices.
Async your icons
Want to speed up your page loads? So do we. Have your icons load in the background so your site loads faster.
Download & Customize Easy
Want to manage and host Font Awesome assets yourself? You can download, customize, and use the icons and default styling manually. Both CSS and CSS Preprocessor (Sass and Less) formats are included.
Using CSS
- Copy the entire font-awesome directory into your project.
- In the of your html, reference the location to your font-awesome.min.css.
rel="stylesheet" href="path/to/font-awesome/css/font-awesome.min.css">
Using Sass or Less
Use this method to customize Font Awesome 4.7.0 using Less or Sass.
- Copy the font-awesome/ directory into your project.
- Open your project’s font-awesome/less/variables.less or font-awesome/scss/_variables.scss and edit the @fa-font-path or $fa-font-path variable to point to your font directory.
Advanced & Packages Pro
Less Ruby Gem
Use the Official Font Awesome Less Ruby Gem to easily get Font Awesome Less into a Rails project. Generously maintained by @supercodepoet.
- Add this line to your application’s Gemfile:
$ gem install font-awesome-less
If you use Rails, add this to your e.g. application.less :
@import "font-awesome-sprockets"; @import "font-awesome";
Sass Ruby Gem
Use the Official Font Awesome Sass Ruby Gem to easily get Font Awesome Sass into a Rails or Compass project. Generously maintained by @supercodepoet.
- Add this line to your application’s Gemfile:
$ gem install font-awesome-sass
If you use Rails, add this to your e.g. application.scss :
@import "font-awesome-sprockets"; @import "font-awesome";
More Information
Validators
In order to provide the best possible experience to old and buggy browsers, Font Awesome uses CSS browser hacks in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren’t yet fully standardized, but these are used purely for progressive enhancement.
These validation warnings don’t matter in practice since the non-hacky portion of our CSS does fully validate and the hacky portions don’t interfere with the proper functioning of the non-hacky portion, hence why we deliberately ignore these particular warnings.
Internet Explorer 8 and @font-face
IE8 has some issues with @font-face when combined with :before . Font Awesome uses that combination. If a page is cached, and loaded without the mouse over the window (i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads. Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well. See issue #954 for details.
Need IE7 Support?
If you need IE7 support, you have my condolences. Really. Font Awesome 4.7.0 doesn’t support IE7, but an older version does. You’ll need to check out the 3.2.1 instructions for using IE7. Then go complain to whoever decided your project needs IE7 support.
Troubleshooting
If you’re having trouble with Font Awesome, make sure to check out the troubleshooting wiki page. Generously maintained by @gtagliala.
Help & Support
Content Delivery Networks (CDN) are used all over the Internet. In short they are Internet servers that deliver all sorts of stuff to browsers and mobile devices faster and with more reliability than just using your own server. If you want to geek out read what Wikipedia says about them.
Why should I use a CDN?
CDNs can help with basic page and asset loading performance, which provides a more responsive and quick experience for your users. Two things are important when we talk about basic performance: the number of requests and the size of the response. There are basically three ways the CDN improve those biggest pain-points in content delivery.
- By having a faster server (latency, concurrency)
- By making sure it’s always available (scaling/distributing load)
- By moving the server physically closer to the browser
How do I use Font Awesome via CDN on my site?
You’ll need to do just a few things in order to get started using Font Awesome via CDN on your project:
Create an Embed Code
Add that Embed Code to Your Project
Drop any of the 600+ icons in
Here’s an abbreviated example of a page that’s using Font Awesome CDN
What do you mean by Auto Accessibility?
Icons are symbols that can convey a ton of information and really help people comprehend directions, signs, and interfaces. Its important that we create and use them so that they can reach the largest amount of people possible. That means making sure our icons play well with technology that helps people navigate and use apps and sites.
According to this article, there are a potentially surprising number of folks with sight and hearing impairments: Blindness, low vision, and visual impairment represent 8.4% of the total world population and disabling hearing loss represents 5.3% of the total world population.
We’ve built-in ways to help technology that supports impairments, like screen readers, either ignore or better understand the Font Awesome icons you’re using. In short, we try to help with the following cases:
Using Icons are Decorative Elements
Using Icons for Semantic or Interactive Purposes
If enabled as a feature in your embed code, Font Awesome CDN will try to identify the scenarios above in your UI as well as provide the modern and proper syntax assistive technologies recognize. For icons that have semantic or interactive meaning, this means you’ll need to provide a proper text alternative to be used. Here’s how:
For icons that are decorative
Font Awesome CDN’s auto accessibility feature will make sure it is ignored by assistive technology. There’s nothing extra you need to on top of how you would usually reference an icon.
Here’s what your markup should be.
And Font Awesome CDN changes that to the following.
For icons that have semantic or interative meaning
Font Awesome CDN’s auto accessibility feature will try to apply a fallback alternative for the icon based on any any alternatives and configuration you set on the icon.
Here’s what your markup should be.
And Font Awesome CDN changes that to the following.
What are asynchronously loading icons?
When a web page loads, there are often many requests for files needed to render the interface and content. This can create a line of assets and information waiting to be understood and then presented by the browser. Some of the requests, such as initial or very important content and basic layout styling, may be needed right away. Others, such as icons, typefaces, and images, may not be as critical to load for users first. To help speed up the loading of pages, its wise to delegate the latter to loading after the critical set.
If enabled as a feature in your embed code, Font Awesome CDN will move the loading of Font Awesome’s icons and supporting styling from the critical request order and load them on a parallel track when the browser is available to.
Account Access
If you have registered with Font Awesome CDN and are having trouble accessing your account, you can always try to recover your password. If that does not work, you can try contacting us for support.
If you’d like to delete your Font Awesome CDN account, we’ll be sorry to see you go. But we’ll be happy to help if you email us at cdn@fontawesome.com.
If you’d like to know about the ins and outs of your registered account, please see our Terms of Service and Privacy Policy.
My icons aren’t rendering correctly
We’re not able to provide direct one-on-one support to all of our customers all of the time, but if you’re having trouble, here are some places to start.
Make sure you’ve set things up properly
Make sure you’re not using another version or copy of Font Awesome
Double-check your icon markup
Double-check your CSS
Ask the community
Still perplexed?
Font Awesome isn’t loading on my pages
Again, We’re not able to provide direct one-on-one support to all of our customers all of the time, but if you’re having trouble, here are some places to start.
Make sure you’ve set things up properly
Triple-check that you’ve referenced your embed code
Ask the community
Still have a boggle?
Find a Bug or Issue?
Found a problem with Font Awesome CDN? Feel free to submit an issue on Font Awesome’s GitHub project. But please keep the following in mind:
- Please be nice. Font Awesome is a happy place.
- Please search to see if your bug was already reported.
- Before opening any issue, please read the generic issue guidelines, by Nicolas Gallagher.
- After doing everything above, feel free to submit an issue.
Questions & Feedback
Font Awesome CDN is still really new. We’re still squashing a few bugs and polishing things. If you notice something that seems off or is causing trouble, let us know by reporting a bug. Got a question, specific idea, or need something? Feel free to get in touch with the Font Awesome Team.