PHPackages                             aerni/font-awesome - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. aerni/font-awesome

ActiveLibrary[Utility & Helpers](/categories/utility)

aerni/font-awesome
==================

A Statamic addon to easily add Font Awesome icons.

v4.0.0(2mo ago)429.5k↓26.9%9[1 issues](https://github.com/aerni/statamic-font-awesome/issues)MITPHPPHP ^8.3

Since Nov 18Pushed 1y ago2 watchersCompare

[ Source](https://github.com/aerni/statamic-font-awesome)[ Packagist](https://packagist.org/packages/aerni/font-awesome)[ Docs](https://github.com/aerni/statamic-font-awesome)[ GitHub Sponsors](https://github.com/aerni)[ RSS](/packages/aerni-font-awesome/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (17)Used By (0)

[![Statamic](https://camo.githubusercontent.com/a03662255a2a7f29df9524d10e2e452d79bf9dc0818c27ce2a51c0ca1a017e4b/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f352e302b2f464632363945)](https://camo.githubusercontent.com/a03662255a2a7f29df9524d10e2e452d79bf9dc0818c27ce2a51c0ca1a017e4b/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f352e302b2f464632363945) [![Packagist version](https://camo.githubusercontent.com/6dbfd5810bfb4d87a7665ee76c8bd19e1c6bc5f40a80380807d601fc4a67eb06/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f666f6e742d617765736f6d652f6c6174657374)](https://camo.githubusercontent.com/6dbfd5810bfb4d87a7665ee76c8bd19e1c6bc5f40a80380807d601fc4a67eb06/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f666f6e742d617765736f6d652f6c6174657374) [![Packagist Total Downloads](https://camo.githubusercontent.com/2941952aaa7a9176b1806f8e1c46f828d2850f874389c1bcd451a707b512254d/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f666f6e742d617765736f6d65)](https://camo.githubusercontent.com/2941952aaa7a9176b1806f8e1c46f828d2850f874389c1bcd451a707b512254d/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f666f6e742d617765736f6d65)

Font Awesome
============

[](#font-awesome)

This Statamic addon features an icon fieldtype to browse and select Font Awesome 6.x icons. It also comes with a Tag to output selected icons in your template.

Installation
------------

[](#installation)

Install the addon using Composer:

```
composer require aerni/font-awesome
```

You may publish the config of the package:

```
php please vendor:publish --tag=font-awesome-config
```

Configuration
-------------

[](#configuration)

You may choose between using a Kit or hosting Font Awesome yourself.

### Kit Driver

[](#kit-driver)

If you want to use a Kit, make sure you set the `driver` option in the config to `kit`:

```
'driver' => 'kit'
```

Next, add your `API Token` and `Kit Token` to your `.env` file:

```
FA_API_TOKEN=************************************
FA_KIT_TOKEN=************************************
```

### Local Driver

[](#local-driver)

If you would rather host Font Awesome yourself, you may use the `local` driver:

```
'driver' => 'local'
```

Next, download [Font Awesome (For The Web)](https://fontawesome.com/download) and place the `metadata` and `css` directories in the locations defined in the config:

```
'local' => [
    'metadata' => resource_path('fonts/fontawesome/metadata'),
    'css' => '/fonts/fontawesome/css/all.min.css',
],
```

#### Metadata

[](#metadata)

The files in the `metadata` directory are required to get the information about the icons. I recommend placing the metadata in the `resources` directory, as these files don't need to be publicly accessible.

#### CSS

[](#css)

The `css` config option defines the public path to the stylesheet that will be loaded in the Control Panel. The stylesheet must be placed in the `public` directory. The CSS will only be loaded in the Control Panel. You still need to add the stylesheet to your frontend layout yourself.

Usage
-----

[](#usage)

### Fieldtype

[](#fieldtype)

Add the `Font Awesome` Fieldtype to a Blueprint or Fieldset. The Fieldtype provides a config option that allows you to make only certain icon styles available for selection.

### Tag

[](#tag)

If you're using the `kit` driver, add the following Tag to your layout's `` to render the Font Awesome script.

```
{{ font_awesome:kit }}
```

Render an icon by using the handle of a Font Awesome field as the wildcard method.

```
{{ font_awesome:icon_field }}
```

You may also use the shorter tag alias instead.

```
{{ fa:kit }}

{{ fa:icon_field }}
```

Credits
-------

[](#credits)

Developed by [Michael Aerni](https://www.michaelaerni.ch)

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance55

Moderate activity, may be stable

Popularity35

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 81.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~105 days

Recently: every ~149 days

Total

16

Last Release

69d ago

Major Versions

v1.3.2 → v2.0.02023-05-12

v2.1.1 → v3.0.02024-07-01

v2.0.1 → v4.0.02026-03-11

PHP version history (3 changes)v1.0.0PHP ^8.0

v2.1.0PHP ^8.1

v4.0.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/7f0a168dc347e5e141dc13cec734d3b0a25a13445069483732580f26f71456a6?d=identicon)[aerni](/maintainers/aerni)

---

Top Contributors

[![aerni](https://avatars.githubusercontent.com/u/23167701?v=4)](https://github.com/aerni "aerni (18 commits)")[![waldemar-p](https://avatars.githubusercontent.com/u/21173835?v=4)](https://github.com/waldemar-p "waldemar-p (2 commits)")[![mnlmaier](https://avatars.githubusercontent.com/u/15020024?v=4)](https://github.com/mnlmaier "mnlmaier (1 commits)")[![Oleafeon](https://avatars.githubusercontent.com/u/20043831?v=4)](https://github.com/Oleafeon "Oleafeon (1 commits)")

---

Tags

statamicstatamic-addonfont-awesomestatamic

### Embed Badge

![Health badge](/badges/aerni-font-awesome/health.svg)

```
[![Health](https://phpackages.com/badges/aerni-font-awesome/health.svg)](https://phpackages.com/packages/aerni-font-awesome)
```

###  Alternatives

[visuellverstehen/statamic-classify

A useful helper to add CSS classes to all HTML tags generated by the bard editor.

20116.8k](/packages/visuellverstehen-statamic-classify)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

2381.5k10](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

13128.3k](/packages/withcandour-aardvark-seo)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2912.8k](/packages/aerni-livewire-forms)[mitydigital/feedamic

A fully-featured RSS and Atom feed generator for Statamic.

1064.0k](/packages/mitydigital-feedamic)[mitydigital/sitemapamic

An XML sitemap generator for Statamic that includes all collections and related taxonomy pages.

1485.2k](/packages/mitydigital-sitemapamic)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)