Font Awesome
The official way to use Font Awesome Free or Pro icons on your WordPress site, brought to you by the Font Awesome team.
Solid choice
Font Awesome is a solid plugin choice in 2026, with a few things worth checking first. It runs on 400K+ sites, is rated 3.6/5 and was last updated 3 months ago, and scores 65/100 on our health check.
- Proven at scale on 400K+ active sites
- Tested with the latest WordPress (7.1)
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Font Awesome stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| FontAwesome | #1 |
| icon | #37 |
| iconfont | #1 |
| SVG icon | #11 |
| webfont | #2 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 3.6 from 61 reviews
About Font Awesome
From the official readme · v5.2.1Description
The official way to use Font Awesome Free or Pro icons on your WordPress site, brought to you by the Font Awesome team.
Features
Our official plugin makes it easy to add Font Awesome icons to your pages, posts, and templates and includes the following features:
- Use Pro or Free icons, from the latest release or a specific release.
- Use custom icons from your Pro Kits.
- Use a Font Awesome Kit to add any of our icons (including the latest Duotone styles and custom icons!), or select the Font Awesome CDN for Version 5 icons only.
- Turn on automatic compatibility for Font Awesome Version 4 if you – or your plugins – are still using Version 4 syntax.
- Troubleshoot and resolve issues when multiple versions of Font Awesome are loading on your site from other plugins/themes, which can cause unexpected icon display or technical issues.
How to Use
Install And Enable The Plugin
(See the Installation tab for details)
How to Add and Style Icons
Full docs on how to use the plugin and add icons are available on the Font Awesome Docs site.
Add Icons in the Block Editor
Once you’ve set up your plugin, you can add icons as blocks or inline with text.
To add icons as blocks, select the “Font Awesome Icon” block, and then click the “Choose Icon button” to open the Icon Chooser.
To add icons inline, select the Font Awesome option in the format toolbar to open the Icon Chooser. (Note: Inline icons require at least WP 6.3.)
Once you open the Icon Chooser, add icons by:
- Searching for the icon you want – you can search by icon name, category, or keyword.
- Changing the Family and Style using the drop downs if you want an icon in a different style.
- When you see the icon you want, clicking it to enter it into the content of your page or post.
Note: If you want to search and add Pro icons in the Icon Chooser, make sure you set your plugin to use a Pro Kit.
Add Icons in The Classic Editor
If you need to add icons in the classic editor, you can use the icon names in shortcodes or HTML. Add an icon using shortcodes to any text area – just add the name of the icon and a style prefix, where the prefix is the style of icon you want to use. Note that you don’t need to include the fa- part of the icon name. And if you don’t include any style prefix, the icon will default to the Classic Solid style.
The shortcode for an icon looks like this:
[icon name="stroopwafel"]
[icon name="stroopwafel" prefix="fa-sharp fa-light"]
You can also use basic HTML with standard Font Awesome syntax, like this:
<i class="fa-solid fa-stroopwafel"></i>
Using Pro Icons and Features
To use a Kit to power your icons, create a Kit on FontAwesome.com and select “Pro icons” in the Kit Settings tab. Then grab your API Token from your Font Awesome Account page and add it to your WordPress plugin settings.
To use the CDN to power your icons, know that you will only be able to use icons from Version 5. To enable Pro icons, add your site’s domain to the list allowed domains on your Font Awesome CDN Settings page and then use shortcodes or HTML to add the icons into your content.
Troubleshooting with the Plugin
Font Awesome icons are popular, so lots of themes and plugins also load Font Awesome, and sometimes their version can conflict with yours. So we created a way to help you find and prevent those conflicting versions from affecting your icons: The Conflict Detection Scanner.
If the plugin seems to be set up correctly and your icons still aren’t loading and you’re not sure why, head over to the Troubleshoot tab, which has two parts:
- Detect Conflicts with Other Versions of Font Awesome – which lets you start the conflict detection scanner to find versions of Font Awesome loading on your site.
- Versions of Font Awesome Active on Your Site – which shows the results of the scanner and lets you prevent any conflicting versions from loading other versions of Font Awesome on your site.
Get more information about using the scanner for troubleshooting on the Font Awesome WordPress docs.
Configuring
The plugin is set to serve Font Awesome Free icons as a Web Font via the Font Awesome CDN by default. You can change the CDN settings right in the plugin. If you want just the basic Free icons, you probably don’t need to make any changes to the default configuration.
You can get more information about all the available settings and troubleshooting on the Font Awesome WordPress docs.
Upgrading from Plugin Version 4
[icon]shortcodes found in Block Editor content and elsewehre will continue to work as before,
though new icons added with the Icon Chooser in the Block Editor will be inline SVGs.
Previously added[icon]shortcodes will not be automatically be converted into the new inline SVG
format. If you want to convert an[icon]shortcode, delete it and re-add the icon using the Icon Chooser in the Block Editor.
See Also
The README on GitHub has details for WordPress site owners and developers.
You can get more information about all the available settings and troubleshooting on the Font Awesome WordPress docs.
And there are API docs for developers.
Installation
From the Plugins Directory in WordPress Admin
From the “Add Plugins” page in WordPress admin:
-
Search the plugins directory by
author: fontawesome -
Click “Install” on the Font Awesome plugin in the search results
-
Click “Activate”
Installing a Zip Archive
-
Click Download on this plugin’s directory entry to get the
.zipfile -
On the “Add Plugins” page in WordPress admin, click “Upload Plugin” and choose that
.zipfile
Access Font Awesome Plugin Settings
Once you activate the Font Awesome plugin, you will see Font Awesome in the Settings menu in your WordPress admin area, or you can click “Settings” on the plugin listing on the Plugins page.
The plugin is set to serve Font Awesome Free icons as a Web Font via the Font Awesome CDN by default. You can change the CDN settings right in the plugin. If you want just the basic Free icons, you probably don’t need to make any changes to the default configuration.
Using Pro Icons and Features
To add icons using a Kit, create a Kit on FontAwesome.com and select “Pro icons” in the settings. Then grab your API Token from your Font Awesome account page to add into the WordPress Kit settings.
To add Pro icons (V5 only) using the CDN, you will need to add your site’s domain to the list allowed domains on your Font Awesome CDN Settings page and use shortcodes or HTML to add the icons into your content.
If you’re using the Icon Chooser, you’ll need to use a Pro Kit. (The CDN can only search and add Free icons – use shortcodes or HTML to add Pro icons when using the CDN).
Changelog
The Icon Chooser in this version is Kit subset aware. Only icons included in a Kit's subset will be available for search and selection. That's a long-requested feature. If it surprises you to see fewer icons available in the Icon Chooser, the solution is to add more icons to your Kit's subset on fontawesome.com. You could even use a Full Library kit to include them all.
5.2.1
- Fix the registration of script translations to enable non-English languages to work
correctly in the plugin’s admin interface.
5.2.0
- Update the icon chooser to be Kit subset aware. Only icons included in a Kit’s subset will be available for search and selection. If it surprises you to see fewer icons available in the Icon Chooser, the solution is to add more icons to your Kit’s subset on fontawesome.com. You could even use a Full Library kit to include them all.
- Fix for WordPress 7 compatibility: loading assets within the block editor content iframe.
5.1.5
- Minor update to the icon chooser, fixing a bug in the previous update.
5.1.4
- Update the icon chooser package. This is only for compatibility with other tools that may be
loaded on a page that also use the icon chooser package. It does not change how the icon chooser
functions in this plugin.
5.1.3
- Resolve a compatibility conflict with Toolset Types in the classic editor.
5.1.2
- Fix a bug where clicking “Style” on a rich text icon (inside a paragraph block, for example), would
result in an error in the block editor. This bug was introduced in 5.1.1 and does not affect
icons created as blocks–only those added as inline rich text.
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Font Awesome alternatives
All FontAwesome plugins →FAQ
Font Awesome: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Nov 17, 2026
Is Font Awesome free?
Yes. Font Awesome is free to download and use from the official WordPress.org plugin directory.
Is Font Awesome safe to use in 2026?
Font Awesome is a solid plugin choice in 2026, with a few things worth checking first. It runs on 400K+ sites, is rated 3.6/5 and was last updated 3 months ago, and scores 65/100 on our health check.
How many websites use Font Awesome?
Font Awesome is active on 400K+ WordPress websites and has been downloaded 6,643,971 times since it launched in September 2012. It was downloaded 38,418 times in the last 30 days.
Does Font Awesome work with WordPress 7.1?
Yes. The developer has tested Font Awesome up to WordPress 7.1.4, the latest release. It requires WordPress 5.8 or newer.
What PHP version does Font Awesome need?
Font Awesome requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Font Awesome last updated?
The latest version, 5.2.1, was released on August 13, 2026 (3 months ago).
Who makes Font Awesome?
Font Awesome is developed and maintained by fontawesome.
What are the best alternatives to Font Awesome?
The most popular alternatives to Font Awesome are Advanced Custom Fields: Fon… (90K+ installs), WP Font Awesome (10K+ installs) and Icon Widget (4K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card