Font Awesome

  Get Started

Easy ways to get Font Awesome 4.0.0 onto your website

Setting up Font Awesome can be as simple as adding two lines of code to your website, or you can be a pro and customize the LESS yourself! Font Awesome even plays nicely with Bootstrap 3!

EASIEST: BootstrapCDN

Add Font Awesome into your website with a single line of code. You don't even have to download or install anything!

  1. Paste the following code into the <head> section of your site's HTML. 
    <link href="//netdna.bootstrapcdn.com/font-awesome/4.0.0/css/font-awesome.css" rel="stylesheet">
  2. Pat yourself on the back for your scalable-vector-icons-on-the-website judo solution in a single line of code.
  3. Check out the examples to start using Font Awesome!

EASY: Default CSS

Use this method to get the default Font Awesome CSS with the default Bootstrap CSS.

  1. Copy the entire font-awesome directory into your project.
  2. In the <head> of your html, reference the location to your font-awesome.min.css. 
    <link rel="stylesheet" href="path/to/font-awesome/css/font-awesome.min.css">
  3. Check out the examples to start using Font Awesome!

EASY: Font Awesome Ruby Gem

Use the Official Font Awesome Ruby Gem to easily get Font Awesome into a Rails project. Generously maintained by @supercodepoet.

  1. Add this line to your application's Gemfile: 
    gem 'font-awesome-sass'
  2. And then execute: 
    $ bundle
  3. Or install it yourself as: 
    $ gem install font-awesome-sass

PRO: Custom LESS or SCSS

Use this method to customize Font Awesome 3.0.0 using LESS or SCSS.

  1. Copy the font-awesome/ directory into your project.
  2. Open your project's font-awesome/variables.less and edit the @fa-font-path or $fa-font-path variable to point to your font directory. 
    @fa-font-path:   "../font";

    The font path is relative from your compiled CSS directory.

  3. Re-compile your LESS or SCSS if using a static compiler. Otherwise, you should be good to go.
  4. Check out the examples to start using Font Awesome!

Need IE7 Support?

If you need IE7 support, you have my condolences. Really. Font Awesome 4.0.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 whomever 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.