---
layout: documentation
doc-tab: elements
doc-subtab: icon
---

{% include subnav-elements.html %}

<section class="section">
  <div class="container">
    <h1 class="title">Icons</h1>
    <h2 class="subtitle">
      Bulma is compatible with <strong><a href="http://fortawesome.github.io/Font-Awesome/">Font Awesome</a></strong> icons.
    </h2>

    <hr>

    <div class="content">
      <p>Because the icons can take a few seconds to load, and because you want control over the <strong>space</strong> the icons will take, you can use the <code>icon</code> class as a container:</p>
    </div>

{% capture icon_example %}
<span class="icon">
  <i class="fa fa-home"></i>
</span>
{% endcapture %}
    <div class="example">
      {{icon_example}}
    </div>

{% highlight html %}
{{icon_example}}
{% endhighlight %}

    <div class="content">
      <p>The <code>icon</code> container will take up <em>exactly</em> <strong>1.5rem x 1.5rem</strong>. The icon itself is sized at <strong>21px</strong>.</p>
    </div>

    <hr>

    <h3 class="title">Sizes</h3>

    <div class="content">
      <p>Font Awesome icons use a font-size of <strong>28px</strong> by default, and are best rendered when using <strong>multiples of 7</strong>.</p>
      <p>The Bulma <code>icon</code> container is always slightly bigger than the font-size used:</p>
    </div>

    <table class="table">
      <thead>
        <tr>
          <th colspan="2">Class</th>
          <th>Font-size</th>
          <th>Container size</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><code>icon is-small</code></td>
          <td><span class="icon is-small"><i class="fa fa-home"></i></span></td>
          <td>14px</td>
          <td>1rem x 1rem</td>
        </tr>
        <tr>
          <td><code>icon</code></td>
          <td><span class="icon"><i class="fa fa-home"></i></span></td>
          <td>21px</td>
          <td>1.5rem x 1.5rem</td>
        </tr>
        <tr>
          <td><code>icon is-medium</code></td>
          <td><span class="icon is-medium"><i class="fa fa-home"></i></span></td>
          <td>28px</td>
          <td>2rem x 2rem</td>
        </tr>
        <tr>
          <td><code>icon is-large</code></td>
          <td><span class="icon is-large"><i class="fa fa-home"></i></span></td>
          <td>42px</td>
          <td>3rem x 3rem</td>
        </tr>
      </tbody>
    </table>
  </div>
</section>