Title: FA WP Admin Menu Icons
Author: Patrik Csak
Published: <strong>March 25, 2017</strong>
Last modified: June 26, 2026

---

Search plugins

![](https://ps.w.org/fa-wp-admin-menu-icons/assets/icon-256x256.png?rev=3075326)

# FA WP Admin Menu Icons

 By [Patrik Csak](https://profiles.wordpress.org/ptrkcsk/)

[Download](https://downloads.wordpress.org/plugin/fa-wp-admin-menu-icons.10.0.0.zip)

 * [Details](https://scn.wordpress.org/plugins/fa-wp-admin-menu-icons/#description)
 * [Reviews](https://scn.wordpress.org/plugins/fa-wp-admin-menu-icons/#reviews)
 *  [Installation](https://scn.wordpress.org/plugins/fa-wp-admin-menu-icons/#installation)
 * [Development](https://scn.wordpress.org/plugins/fa-wp-admin-menu-icons/#developers)

 [Support](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/)

## Description

[View on GitHub](https://github.com/patrik-csak/fa-wp-admin-menu-icons) for better
documentation

**FA WP Admin Menu Icons** allows you to use Font Awesome icons for WordPress custom
post types and custom menu pages by passing the Font Awesome class string, just 
like using Font Awesome on the front end

Here’s an example:

    ```
    register_post_type( 'custom_post_type', [
        //...
        'menu_icon' => 'fa-solid fa-thumbs-up',
        //...
    ] );
    ```

### Usage

#### `register_post_type()`

To use a Font Awesome icon for your custom post type with [`register_post_type()`](https://developer.wordpress.org/reference/functions/register_post_type/),
use a Font Awesome class string for the `$args['menu_icon]` parameter:

    ```
    register_post_type( 'custom_post_type', [
        //...
        'menu_icon' => 'fa-solid fa-thumbs-up',
        //...
    ] );
    ```

#### `add_menu_page()`

To use a Font Awesome icon for your custom menu page with [`add_menu_page()`](https://developer.wordpress.org/reference/functions/add_menu_page/),
use a Font Awesome class string for the `$icon_url` parameter:

    ```
    add_menu_page(
        page_title: 'Custom Menu Page',
        menu_title: 'Custom Menu Page',
        capability: 'manage_options',
        menu_slug: 'custom_menu_page',
        icon_url: 'fa-solid fa-thumbs-up',
    );
    ```

#### Custom Post Type UI plugin

To use a Font Awesome icon with the [Custom Post Type UI plugin](https://wordpress.org/plugins/custom-post-type-ui/),
use a Font Awesome class string for the **Menu Icon** field when adding or editing
a Post Type

### Caveats

FA WP Admin Menu Icons only supports Font Awesome’s [free icons](https://fontawesome.com/search?ic=free&o=r)

## Screenshots

[⌊Screenshot of WordPress Admin Dashboard menu with an example custom post type 
and custom menu page which use the Font Awesome flag icon⌉⌊Screenshot of WordPress
Admin Dashboard menu with an example custom post type and custom menu page which
use the Font Awesome flag icon⌉[

Screenshot of WordPress Admin Dashboard menu with an example custom post type and
custom menu page which use the Font Awesome flag icon

[⌊Screenshot of Custom Post Type UI Menu Icon field populated with 'fa-solid fa-
thumbs-up'⌉⌊Screenshot of Custom Post Type UI Menu Icon field populated with 'fa-
solid fa-thumbs-up'⌉[

Screenshot of Custom Post Type UI Menu Icon field populated with ‘fa-solid fa-thumbs-
up’

## Installation

#### WordPress Admin Dashboard

In your WordPress Admin Dashboard, go to **Plugins > Add New**, search for ‘fa wp
admin menu icons’, then click **Install Now**

Read more about [automatic plugin installation with the WordPress Admin Dashboard](https://wordpress.org/support/article/managing-plugins/#automatic-plugin-installation-1)

#### WP-CLI

Install with WP-CLI by running the following command:

    ```
    wp plugin install fa-wp-admin-menu-icons --activate
    ```

#### Install with Composer

 1. Follow the setup instructions for [WordPress Packagist](https://wpackagist.org)
 2. Require `wpackagist-plugin/fa-wp-admin-menu-icons`

#### Install with Git

Install with Git by running the following commands:

    ```
    cd <wp-content>/plugins
    git clone git@github.com:patrik-csak/fa-wp-admin-menu-icons.git
    ```

## Reviews

![](https://secure.gravatar.com/avatar/22bd0988dd369096995e4f168ff564f5e1bfb3faff0d5c91cf34422296b28ccb?
s=60&d=retro&r=g)

### 󠀁[Works and is so easy!](https://wordpress.org/support/topic/works-and-is-so-easy/)󠁿

 [Kitty](https://profiles.wordpress.org/k1t/) November 9, 2021 1 reply

I needed a horse menu icon. My custom one looked terrible. This was perfect. Installed
and working in 2 minutes, so easy!

![](https://secure.gravatar.com/avatar/90be7aad0612f22ecd099b0454e86df76183dd82e60ab72faf524224a2407148?
s=60&d=retro&r=g)

### 󠀁[It works, easy to configure](https://wordpress.org/support/topic/it-works-easy-to-configure/)󠁿

 [Christian Saborio](https://profiles.wordpress.org/christian-saborio/) May 7, 2019
1 reply

I don’t know what the reviewer below is crying about in terms of a ReadMe, the description
lists all you need to know. I had my font awesome menu icon displaying in seconds
thanks to this. Appreciate the author’s time to create and distribute! 🙂

![](https://secure.gravatar.com/avatar/ddb0fd351e6f1fbe8454b94a80461f5169a6cd6639c3de93f267bdff6df437f2?
s=60&d=retro&r=g)

### 󠀁[Does the job!](https://wordpress.org/support/topic/does-the-job-506/)󠁿

 [Robin Appelblom](https://profiles.wordpress.org/robinappelblom/) October 16, 2018
1 reply

Did exactly what I needed, to be able to use Font Awesome together with the Custom
Post Type UI plugin. You just add the Font Awesome class as the Menu Icon. Thanks
a lot!

![](https://secure.gravatar.com/avatar/8658805baadbc2304ce41924693f3de6f60b15c5fe76b30c3d76b2f542388dff?
s=60&d=retro&r=g)

### 󠀁[Junk](https://wordpress.org/support/topic/junk-24/)󠁿

 [gdengines2](https://profiles.wordpress.org/gdengines2/) September 26, 2018 1 reply

Clearly, it isn’t “plug” and play. After install, I couldn’t figure out what it 
changed, where to change stuff at (icons to the menu). No documentation on how to
use after install.

![](https://secure.gravatar.com/avatar/2ffa713b3223cba8a8f1afe508b4ac01887d600e1001bd9cd4927eb544076427?
s=60&d=retro&r=g)

### 󠀁[Does what it should!](https://wordpress.org/support/topic/does-what-it-should-45/)󠁿

 [ukeboyska](https://profiles.wordpress.org/ukeboyska/) July 6, 2017

Very easy to put in fontawesome icons, so I don’t just have to choose from the boring
old dashicons.

 [ Read all 5 reviews ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/)

## Contributors & Developers

“FA WP Admin Menu Icons” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Patrik Csak ](https://profiles.wordpress.org/ptrkcsk/)

[Translate “FA WP Admin Menu Icons” into your language.](https://translate.wordpress.org/projects/wp-plugins/fa-wp-admin-menu-icons)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/fa-wp-admin-menu-icons/),
check out the [SVN repository](https://plugins.svn.wordpress.org/fa-wp-admin-menu-icons/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/fa-wp-admin-menu-icons/)
by [RSS](https://plugins.trac.wordpress.org/log/fa-wp-admin-menu-icons/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 10.0.0

**Changed**

 * Require PHP v8.2+
 * Update Font Awesome from v7.2.0 to v7.3.0

#### 9.1.0

**Added**

 * Support for PHP v8.5

#### 9.0.0

**Changed**

 * Upgrade Font Awesome from v6.6.0 to v7.0.0

#### 8.4.0

**Changed**

 * Upgrade Font Awesome from v6.5.2 to v6.6.0

#### 8.3.0

**Changed**

 * Upgrade Font Awesome from v6.5.1 to v6.5.2

#### 8.2.0

**Changed**

 * Decreased icon size to be more similar to Dashicons

#### 8.1.1

**Changed**

 * Require PHP v8.1 in readme.txt

#### 8.1.0

**Changed**

 * Upgrade Font Awesome from v6.5.0 to v6.5.1

#### 8.0.0

**Changed**

 * Upgrade Font Awesome from v6.4.0 to v6.5.0
 * Require PHP v8.1+

#### 7.2.0

**Changed**

 * Upgrade Font Awesome to v6.4.0

#### 7.1.0

**Changed**

 * Upgrade Font Awesome to v6.3.0

#### 7.0.0

**Changed**

 * Require PHP v8.0+

**Removed**

 * Support for Font Awesome v4 icons
 * `Fawpami\\faVersion` filter

#### 6.0.0

**Changed**

 * Require PHP v7.4+
 * Test with WordPress v5.9

#### 5.0.1

**Changed**

 * Upgrade Font Awesome to v5.15.4
 * Test with WordPress v5.8.1

#### 5.0.0

**Changed**

 * Upgrade Font Awesome to v5.15.1
 * Test with WordPress v5.5.3
 * Drop support for PHP v7.2

#### 4.1.0

**Changed**

 * Test with WordPress v5.2.1
 * Upgrade Font Awesome to v5.13.0

#### 4.0.0

**Removed**

 * Support for EOL PHP versions

#### 3.9.1

**Added**

 * Restore support for EOL PHP versions because it’s a breaking change

#### 3.9.0

**Changed**

 * Upgrade Font Awesome to v5.12.1

**Removed**

 * Support for EOL PHP versions

#### 3.8.0

**Changed**

 * Update Font Awesome from v5.9.0 to v5.11.2

#### 3.7.0

**Added**

 * Test with WordPress v5.2.1
 * Add support for PHP v7.3

**Changed**

 * Update Font Awesome from v5.6.0 to v5.9.0

#### 3.6.0

**Changed**

 * Update Font Awesome from v5.5.0 to v5.6.0

#### 3.5.0

**Changed**

 * Update Font Awesome from v5.4.2 to v5.5.0

#### 3.4.0

**Changed**

 * Update Font Awesome from v5.4.1 to v5.4.2

#### 3.3.0

**Changed**

 * Update Font Awesome from v5.3.1 to v5.4.1

#### 3.2.0

**Changed**

 * Update Font Awesome from v5.2.0 to v5.3.1

#### 3.1.0

**Changed**

 * Update Font Awesome from v5.1.0 to v5.2.0

#### 3.0.0

**Changed**

 * Initialize the plugin earlier in the WP lifecycle

#### 2.8.0

**Added**

 * Tested with WordPress v4.9.6

**Changed**

 * Update Font Awesome from v5.0.13 to v5.1.0

#### 2.7.0

**Changed**

 * Update Font Awesome from v5.0.12 to v5.0.13

#### 2.6.0

**Changed**

 * Update Font Awesome from v5.0.11 to v5.0.12

#### 2.5.0

**Changed**

 * Update Font Awesome from v5.0.10 to v5.0.11

#### 2.4.0

**Changed**

 * Update Font Awesome from v5.0.9 to v5.0.10

#### 2.3.1

**Changed**

 * Update README.txt changelog

#### 2.3.0

**Changed**

 * Bump Font Awesome version from 5.0.8 to 5.0.9

#### 2.2.1

**Fixed**

 * Fix styles action

#### 2.2.0

**Added**

 * Add support for Font Awesome versions. Icons are now cached with their Font Awesome
   version so they can be updated when the Font Awesome version changes.

#### 2.1.0

**Added**

 * Add links to changelog
 * Add links to readme badges
 * Integrate Travis and Code Climate test coverage

**Changed**

 * Instead of storing all icons in the plugin, get them remotely, as needed, and
   cache them in the database for future use
 * Make hooks code DRYer
 * Stop using static methods, to make testing easier
 * Make icons smaller so they look better next to Dashicons
 * Update Font Awesome shims

#### 2.0.1

**Added**

 * Add CC BY 4.0 attribution in `icons/README.md` to adhere to [Font Awesome license](https://fontawesome.com/license)

**Fixed**

 * Fix old syntax in readme examples
 * Add missing ‘Usage’ section to `README.txt`

#### 2.0.0

**Added**

 * Add unit tests

**Changed**

 * Upgrade to Font Awesome 5 icons and class syntax
 * Use PSR instead of WordPress for code style

**Deprecated**

 * Deprecate use of Font Awesome 4 class syntax

#### 1.0.4

**Changed**

 * Format code

**Removed**

 * Remove caveat from documentation because it no longer applies

#### 1.0.3

**Added**

 * Add more icons

#### 1.0.2

**Fixed**

 * Fix undefined index

#### 1.0.1

**Fixed**

 * Add icons to `icons/`. The directory was empty on the WordPress plugin repository.

#### 1.0.0

## Meta

 *  Version **10.0.0**
 *  Last updated **3 weeks ago**
 *  Active installations **100+**
 *  WordPress version ** 4.4 or higher **
 *  Tested up to **7.0.1**
 *  PHP version ** 8.2 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/fa-wp-admin-menu-icons/)
 * Tags
 * [custom](https://scn.wordpress.org/plugins/tags/custom/)[FontAwesome](https://scn.wordpress.org/plugins/tags/fontawesome/)
   [icon](https://scn.wordpress.org/plugins/tags/icon/)[icons](https://scn.wordpress.org/plugins/tags/icons/)
 *  [Advanced View](https://scn.wordpress.org/plugins/fa-wp-admin-menu-icons/advanced/)

## Ratings

 4.2 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/reviews/)

## Contributors

 *   [ Patrik Csak ](https://profiles.wordpress.org/ptrkcsk/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/fa-wp-admin-menu-icons/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.buymeacoffee.com/patrikcsak)