Use the Font Awesome plugin to add Free or Pro icons to WordPress pages, posts, and templates. Choose the latest release or a specific release. By default, the add-on serves Free icons as a web font through the CDN; you can change the source in the plugin settings.

Choose a Kit or the CDN

A Kit connects WordPress to your Font Awesome icons. To use Pro icons in the Icon Chooser, make a Kit, enable Pro icons in its settings, then add your account API Token to the plugin settings. Kits can provide Duotone styles and custom icons from Pro Kits. The Icon Chooser searches only icons included in the Kit subset, so its results depend on the Kit contents.

The CDN can serve Free icons, including Version 6 Free. Pro icons through the CDN are limited to Version 5. The CDN Icon Chooser searches and adds Free icons; use a Pro Kit to find Pro icons in the chooser. To add Pro icons through the CDN with shortcodes or HTML, first add your site domain to the allowed domains in the CDN settings.

Insert icons with the block editor

Add an icon as a Font Awesome Icon block, or place one inline using the Font Awesome option in the format toolbar. Inline icons require WordPress 6.3 or later. In the Icon Chooser, search by icon name, category, or keyword, then choose a family and style before inserting the icon.

Use shortcodes or HTML in the classic editor

In a classic-editor text area, insert an icon with a shortcode that names the icon and optionally specifies a style prefix. The icon name does not need the fa- prefix. Without a style prefix, the shortcode uses the Classic Solid style. For example: [icon name="stroopwafel" prefix="fa-sharp fa-light"]. Basic HTML using standard Font Awesome syntax is also supported, such as <i class="fa-solid fa-stroopwafel"></i>.

Check compatibility and conflicts

Automatic compatibility supports Font Awesome Version 4 syntax for websites or extensions that still use it. If a theme or another plugin loads a conflicting Font Awesome version, the Conflict Detection Scanner can identify versions active on the website and help prevent conflicts that cause unexpected icon display or technical issues.

Configure the plugin

Install and activate the plugin, then open its settings to choose a Kit or the CDN. For a Kit, enable Pro icons in the Kit settings and add its API Token in WordPress. Once the source is configured, insert icons using the editor, shortcodes, or HTML.