{"id":687,"date":"2012-09-18T02:13:29","date_gmt":"2012-09-18T02:13:29","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/font-awesome\/"},"modified":"2026-04-01T18:26:55","modified_gmt":"2026-04-01T18:26:55","slug":"font-awesome","status":"publish","type":"plugin","link":"https:\/\/eo.wordpress.org\/plugins\/font-awesome\/","author":16537391,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"5.1.4","stable_tag":"5.1.4","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Font Awesome","header_author":"Font Awesome","header_description":"","assets_banners_color":"1864ab","last_updated":"2026-04-01 18:26:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/fontawesome.com\/how-to-use\/on-the-web\/using-with\/wordpress","header_author_uri":"https:\/\/fontawesome.com\/","rating":3.6,"author_block_rating":0,"active_installs":400000,"downloads":5857885,"num_ratings":61,"support_threads":2,"support_threads_resolved":1,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1":{"tag":"1.1","author":"rachelbaker","date":"2012-09-18 15:30:53"},"3.1":{"tag":"3.1","author":"rachelbaker","date":"2013-05-14 02:15:01"},"3.2.1":{"tag":"3.2.1","author":"rachelbaker","date":"2018-12-11 16:15:33"},"4.0.0":{"tag":"4.0.0","author":"mlwilkerson","date":"2021-08-06 00:10:49"},"4.0.0-rc1":{"tag":"4.0.0-rc1","author":"mlwilkerson","date":"2018-12-11 20:06:40"},"4.0.0-rc10":{"tag":"4.0.0-rc10","author":"mlwilkerson","date":"2019-06-07 20:47:46"},"4.0.0-rc11":{"tag":"4.0.0-rc11","author":"mlwilkerson","date":"2019-06-24 20:44:03"},"4.0.0-rc12":{"tag":"4.0.0-rc12","author":"mlwilkerson","date":"2019-06-28 22:47:10"},"4.0.0-rc13":{"tag":"4.0.0-rc13","author":"mlwilkerson","date":"2019-07-31 23:51:58"},"4.0.0-rc15":{"tag":"4.0.0-rc15","author":"mlwilkerson","date":"2020-03-05 20:18:36"},"4.0.0-rc16":{"tag":"4.0.0-rc16","author":"mlwilkerson","date":"2020-03-06 23:31:59"},"4.0.0-rc17":{"tag":"4.0.0-rc17","author":"mlwilkerson","date":"2020-03-10 22:19:58"},"4.0.0-rc18":{"tag":"4.0.0-rc18","author":"mlwilkerson","date":"2020-03-17 18:18:54"},"4.0.0-rc19":{"tag":"4.0.0-rc19","author":"mlwilkerson","date":"2020-03-18 23:34:13"},"4.0.0-rc2":{"tag":"4.0.0-rc2","author":"mlwilkerson","date":"2018-12-11 21:50:18"},"4.0.0-rc20":{"tag":"4.0.0-rc20","author":"mlwilkerson","date":"2020-04-23 03:10:17"},"4.0.0-rc21":{"tag":"4.0.0-rc21","author":"mlwilkerson","date":"2020-11-13 00:04:13"},"4.0.0-rc22":{"tag":"4.0.0-rc22","author":"mlwilkerson","date":"2021-04-07 22:08:51"},"4.0.0-rc23":{"tag":"4.0.0-rc23","author":"mlwilkerson","date":"2021-06-03 19:14:40"},"4.0.0-rc3":{"tag":"4.0.0-rc3","author":"mlwilkerson","date":"2018-12-11 22:34:40"},"4.0.0-rc4":{"tag":"4.0.0-rc4","author":"mlwilkerson","date":"2018-12-12 22:29:50"},"4.0.0-rc5":{"tag":"4.0.0-rc5","author":"mlwilkerson","date":"2018-12-13 01:24:41"},"4.0.0-rc6":{"tag":"4.0.0-rc6","author":"mlwilkerson","date":"2018-12-14 22:47:35"},"4.0.0-rc7":{"tag":"4.0.0-rc7","author":"mlwilkerson","date":"2019-01-17 14:39:38"},"4.0.0-rc8":{"tag":"4.0.0-rc8","author":"mlwilkerson","date":"2019-03-21 15:06:10"},"4.0.0-rc9":{"tag":"4.0.0-rc9","author":"mlwilkerson","date":"2019-04-02 18:44:55"},"4.0.1":{"tag":"4.0.1","author":"mlwilkerson","date":"2021-08-06 23:40:23"},"4.0.2":{"tag":"4.0.2","author":"mlwilkerson","date":"2021-08-26 00:32:28"},"4.0.3":{"tag":"4.0.3","author":"mlwilkerson","date":"2021-09-03 18:57:43"},"4.0.4":{"tag":"4.0.4","author":"mlwilkerson","date":"2021-09-13 23:12:42"},"4.1.0":{"tag":"4.1.0","author":"mlwilkerson","date":"2022-01-27 00:09:35"},"4.1.1":{"tag":"4.1.1","author":"mlwilkerson","date":"2022-05-20 16:58:56"},"4.2.0":{"tag":"4.2.0","author":"mlwilkerson","date":"2022-06-16 14:44:57"},"4.3.0":{"tag":"4.3.0","author":"mlwilkerson","date":"2022-09-01 16:40:31"},"4.3.1":{"tag":"4.3.1","author":"mlwilkerson","date":"2022-09-01 23:46:26"},"4.3.2":{"tag":"4.3.2","author":"mlwilkerson","date":"2022-12-21 23:44:04"},"4.4.0":{"tag":"4.4.0","author":"mlwilkerson","date":"2023-08-03 18:17:12"},"4.5.0":{"tag":"4.5.0","author":"mlwilkerson","date":"2025-01-13 19:57:32"},"5.0.0":{"tag":"5.0.0","author":"mlwilkerson","date":"2025-02-24 19:57:58"},"5.0.1":{"tag":"5.0.1","author":"mlwilkerson","date":"2025-02-26 19:27:19"},"5.0.2":{"tag":"5.0.2","author":"mlwilkerson","date":"2025-06-02 22:36:19"},"5.1.0":{"tag":"5.1.0","author":"mlwilkerson","date":"2025-07-22 23:27:14"},"5.1.1":{"tag":"5.1.1","author":"mlwilkerson","date":"2025-09-25 21:22:01"},"5.1.2":{"tag":"5.1.2","author":"mlwilkerson","date":"2025-09-26 16:07:23"},"5.1.3":{"tag":"5.1.3","author":"mlwilkerson","date":"2025-12-17 22:34:23"},"5.1.4":{"tag":"5.1.4","author":"mlwilkerson","date":"2026-04-01 18:26:55"},"5.2.0-1":{"tag":"5.2.0-1","author":"mlwilkerson","date":"2025-12-15 19:04:54"}},"upgrade_notice":{"5.1.1":"<ul>\n<li>When upgrading to this version, you&#039;ll need to reload the WP admin dashboard, or simply visit the Font Awesome plugin&#039;s settings page, in order to cause the plugin to re-fetch a required SVG stylesheet.<\/li>\n<\/ul>","5.0.1":"<ul>\n<li>When upgrading to this version, you&#039;ll need to reload the WP admin dashboard, or simply visit the Font Awesome\nplugin&#039;s settings page, in order to cause the plugin to fetch a required SVG stylesheet. The correct stylesheet\nis also automatically retrieved any time the plugin&#039;s settings are changed. See the Changelog for how to disable\nthe loading of this stylesheet if you do not use the Block Editor.<\/li>\n<\/ul>","5.0.0":"<ul>\n<li>In the Block Editor, the Icon Chooser now inserts inline SVGs instead of shortcodes.<\/li>\n<li>Removes support for Font Awesome 3 icon names in <code>[icon]<\/code> shortcodes.<\/li>\n<li>Minimum required version of WordPress is now 5.8.<\/li>\n<li>Minimum required version of PHP is now 7.4.<\/li>\n<\/ul>","4.3.0":"<p>Introduces support for multisite. On multisite configurations, previous installations of this plugin must be cleaned up before attempting to upgrade to this version. See Changelog for details.<\/p>","4.0.1":"<p>Fixes bugs in the editor integration with the new Icon Chooser, introduced in 4.0.0. Temporarily disables Icon Chooser integration from Classic Editor in WordPress 4. See Changelog.<\/p>","4.0":"<p>The 4.0 official release from the Font Awesome team is a major upgrade from the previous 3.x plugin. Only one breaking change from previous release candidate: plugin no longer adds a filter to process shortcodes in widget text. Adds an Icon Chooser feature. See Changelog for details.<\/p>","4.0.0-rc22":"<p>This update changes how plugin configuration and metadata are stored in the WordPress database. Automatically updates database entries upon first use. See Changelog.<\/p>","4.0.0-rc17":"<p>Security update. All users of 4.0.0-rc15 or 4.0.0-rc16 should update immediately. See Changelog.<\/p>","4.0.0-rc15":"<p>MAJOR UPDATE, some breaking changes for developers. Improves conflict detection, adds support for Kits and internationalization. See Changelog for important details.<\/p>","4.0.0-rc1":"<p>New plugin, replacing the old one. Font Awesome 3 icon names are being phased out, with a gradual upgrade path.<\/p>"},"ratings":{"1":16,"2":4,"3":2,"4":3,"5":36},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":1991998,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":1991998,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":1991998,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":1991993,"resolution":"772x250","location":"assets","locale":""},"banner.svg":{"filename":"banner.svg","revision":1991998,"resolution":false,"location":"assets","locale":false}},"assets_blueprints":{},"all_blocks":{"font-awesome\/icon":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"font-awesome\/icon","version":"0.1.0","title":"Font Awesome Icon","category":"design","description":"Add a Font Awesome icon.","attributes":{"iconLayers":{"type":"array"},"justification":{"type":"string"}},"supports":{"anchor":true,"align":["left","center","right"],"ariaLabel":true,"color":{"text":false,"background":true,"enableConstrastChecker":true,"gradients":true},"spacing":{"margin":true,"padding":true},"html":false},"textdomain":"font-awesome","editorScript":"font-awesome-block-editor","editorStyle":"font-awesome-block-editor"}},"tagged_versions":["1.1","3.1","3.2.1","4.0.0","4.0.0-rc1","4.0.0-rc10","4.0.0-rc11","4.0.0-rc12","4.0.0-rc13","4.0.0-rc15","4.0.0-rc16","4.0.0-rc17","4.0.0-rc18","4.0.0-rc19","4.0.0-rc2","4.0.0-rc20","4.0.0-rc21","4.0.0-rc22","4.0.0-rc23","4.0.0-rc3","4.0.0-rc4","4.0.0-rc5","4.0.0-rc6","4.0.0-rc7","4.0.0-rc8","4.0.0-rc9","4.0.1","4.0.2","4.0.3","4.0.4","4.1.0","4.1.1","4.2.0","4.3.0","4.3.1","4.3.2","4.4.0","4.5.0","5.0.0","5.0.1","5.0.2","5.1.0","5.1.1","5.1.2","5.1.3","5.1.4","5.2.0-1"],"block_files":[],"assets_screenshots":{"screenshot-1.gif":{"filename":"screenshot-1.gif","revision":3245972,"resolution":"1","location":"assets","locale":""},"screenshot-2.gif":{"filename":"screenshot-2.gif","revision":3245972,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3245972,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3245972,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3245972,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3245972,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3245972,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"Add icons as blocks","2":"Add icons inline with text","3":"Search and add icons from Font Awesome Free or Pro (with subscription)","4":"Style icons (size, color, rotate, flip)","5":"Animate your icons","6":"Use a Font Awesome Kit to power your site's icons","7":"Detect and fix issues with conflicting versions of Font Awesome running on your site"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[4594,497,59742,222779,7831],"plugin_category":[43,50],"plugin_contributors":[182684,165281,183125,165282,165283],"plugin_business_model":[],"class_list":["post-687","plugin","type-plugin","status-publish","hentry","plugin_tags-fontawesome","plugin_tags-icon","plugin_tags-iconfont","plugin_tags-svg-icon","plugin_tags-webfont","plugin_category-customization","plugin_category-media","plugin_contributors-deathnfudge","plugin_contributors-fontawesome","plugin_contributors-frrrances","plugin_contributors-mlwilkerson","plugin_contributors-robmadole","plugin_committers-fontawesome","plugin_committers-mlwilkerson","plugin_committers-robmadole","plugin_support_reps-fontawesome","plugin_support_reps-mlwilkerson","plugin_support_reps-robmadole"],"banners":{"banner":"https:\/\/ps.w.org\/font-awesome\/assets\/banner-772x250.png?rev=1991993","banner_2x":"https:\/\/ps.w.org\/font-awesome\/assets\/banner-1544x500.png?rev=1991998","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/font-awesome\/assets\/icon-128x128.png?rev=1991998","icon_2x":"https:\/\/ps.w.org\/font-awesome\/assets\/icon-256x256.png?rev=1991998","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-1.gif?rev=3245972","caption":"Add icons as blocks"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-2.gif?rev=3245972","caption":"Add icons inline with text"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-3.png?rev=3245972","caption":"Search and add icons from Font Awesome Free or Pro (with subscription)"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-4.png?rev=3245972","caption":"Style icons (size, color, rotate, flip)"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-5.png?rev=3245972","caption":"Animate your icons"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-6.png?rev=3245972","caption":"Use a Font Awesome Kit to power your site's icons"},{"src":"https:\/\/ps.w.org\/font-awesome\/assets\/screenshot-7.png?rev=3245972","caption":"Detect and fix issues with conflicting versions of Font Awesome running on your site"}],"raw_content":"<!--section=description-->\n<p>The official way to use Font Awesome Free or Pro icons on your WordPress site, brought to you by the Font Awesome team.<\/p>\n\n<h4>Features<\/h4>\n\n<p>Our official plugin makes it easy to add Font Awesome icons to your pages, posts, and templates and includes the following features:<\/p>\n\n<ul>\n<li>Use <strong>Pro or Free icons<\/strong>, from the latest release or a specific release.<\/li>\n<li>Use <strong>custom icons<\/strong> from your Pro Kits.<\/li>\n<li>Use a <strong>Font Awesome Kit<\/strong> to add any of our icons (including the latest Duotone styles and custom icons!), or select the Font Awesome <strong>CDN for Version 5 icons only<\/strong>.<\/li>\n<li>Turn on automatic <strong>compatibility for Font Awesome Version 4<\/strong> if you - or your plugins - are still using Version 4 syntax.<\/li>\n<li><strong>Troubleshoot and resolve issues<\/strong> when multiple versions of Font Awesome are loading on your site from other plugins\/themes, which can cause unexpected icon display or technical issues.<\/li>\n<\/ul>\n\n<h3>How to Use<\/h3>\n\n<p><strong>Install And Enable The Plugin<\/strong>\n(See the Installation tab for details)<\/p>\n\n<p><strong>How to Add and Style Icons<\/strong>\nFull docs on how to use the plugin and add icons are available on the <a href=\"https:\/\/docs.fontawesome.com\/web\/use-with\/wordpress\/add-icons\">Font Awesome Docs site<\/a>.<\/p>\n\n<p><strong>Add Icons in the Block Editor<\/strong>\nOnce you\u2019ve set up your plugin, you can add icons as blocks or inline with text.<\/p>\n\n<p>To add icons as blocks, select the \"Font Awesome Icon\" block, and then click the \"Choose Icon button\" to open the Icon Chooser.<\/p>\n\n<p>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.)<\/p>\n\n<p>Once you open the Icon Chooser, add icons by:<\/p>\n\n<ol>\n<li>Searching for the icon you want - you can <strong>search by icon name, category, or keyword<\/strong>.<\/li>\n<li>Changing the Family and Style using the drop downs if you want an icon in a different style.<\/li>\n<li>When you see the icon you want, clicking it to enter it into the content of your page or post.<\/li>\n<\/ol>\n\n<p><em>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.<\/em><\/p>\n\n<p><strong>Add Icons in The Classic Editor<\/strong>\nIf you need to add icons in the classic editor, you can <a href=\"https:\/\/fontawesome.com\/icons?d=gallery\">use the icon names in shortcodes or HTML<\/a>. Add an icon using shortcodes to any text area - just add the name of the icon and a style prefix, where <a href=\"https:\/\/fontawesome.com\/how-to-use\/on-the-web\/referencing-icons\/basic-use\">the prefix is the style of icon<\/a> you want to use. Note that you don\u2019t need to include the <code>fa-<\/code> part of the icon name. And if you don\u2019t include any style prefix, the icon will default to the Classic Solid style.<\/p>\n\n<p>The shortcode for an icon looks like this:<\/p>\n\n<pre><code>[icon name=\"stroopwafel\"]\n\n[icon name=\"stroopwafel\" prefix=\"fa-sharp fa-light\"]\n<\/code><\/pre>\n\n<p>You can also use basic HTML with <a href=\"https:\/\/fontawesome.com\/how-to-use\/on-the-web\/referencing-icons\/basic-use\">standard Font Awesome syntax<\/a>, like this:<\/p>\n\n<pre><code>&lt;i class=\"fa-solid fa-stroopwafel\"&gt;&lt;\/i&gt;\n<\/code><\/pre>\n\n<p><strong>Using Pro Icons and Features<\/strong>\nTo use a Kit to power your icons, <a href=\"https:\/\/fontawesome.com\/kits\">create a Kit on FontAwesome.com<\/a> and select \"Pro icons\" in the Kit Settings tab. Then grab your <a href=\"https:\/\/fontawesome.com\/account#api-tokens\">API Token from your Font Awesome Account page<\/a> and add it to your WordPress plugin settings.<\/p>\n\n<p>To use the CDN to power your icons, know that you will <strong>only be able to use icons from Version 5<\/strong>. To enable Pro icons, add your site's domain to the list allowed domains on your <a href=\"https:\/\/fontawesome.com\/account\/cdn\">Font Awesome CDN Settings page<\/a> and then use shortcodes or HTML to add the icons into your content.<\/p>\n\n<p><strong>Troubleshooting with the Plugin<\/strong>\nFont 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: <strong>The Conflict Detection Scanner<\/strong>.<\/p>\n\n<p>If the plugin seems to be set up correctly and your icons still aren\u2019t loading and you're not sure why, head over to the Troubleshoot tab, which has two parts:<\/p>\n\n<ul>\n<li><em>Detect Conflicts with Other Versions of Font Awesome<\/em> - which lets you start the conflict detection scanner to find versions of Font Awesome loading on your site.<\/li>\n<li><em>Versions of Font Awesome Active on Your Site<\/em> - which shows the results of the scanner and lets  you prevent any conflicting versions from loading other versions of Font Awesome on your site.<\/li>\n<\/ul>\n\n<p>Get more information about using the scanner for troubleshooting on the <a href=\"https:\/\/docs.fontawesome.com\/web\/use-with\/wordpress\/troubleshoot\">Font Awesome WordPress docs<\/a>.<\/p>\n\n<h3>Configuring<\/h3>\n\n<p>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.<\/p>\n\n<p>You can get more information about all the available settings and troubleshooting on the <a href=\"https:\/\/docs.fontawesome.com\/web\/use-with\/wordpress\">Font Awesome WordPress docs<\/a>.<\/p>\n\n<h3>Upgrading from Plugin Version 4<\/h3>\n\n<ul>\n<li><code>[icon]<\/code> shortcodes found in Block Editor content and elsewehre will continue to work as before,\nthough new icons added with the Icon Chooser in the Block Editor will be inline SVGs.\nPreviously added <code>[icon]<\/code> shortcodes will not be automatically be converted into the new inline SVG\nformat. If you want to convert an <code>[icon]<\/code> shortcode, delete it and re-add the icon using the Icon Chooser in the Block Editor.<\/li>\n<\/ul>\n\n<h3>See Also<\/h3>\n\n<p>The <a href=\"https:\/\/github.com\/FortAwesome\/wordpress-fontawesome\/blob\/master\/README.md\">README<\/a> on GitHub has details for WordPress site owners and developers.<\/p>\n\n<p>You can get more information about all the available settings and troubleshooting on the <a href=\"https:\/\/docs.fontawesome.com\/web\/use-with\/wordpress\">Font Awesome WordPress docs<\/a>.<\/p>\n\n<p>And there are <a href=\"https:\/\/fortawesome.github.io\/wordpress-fontawesome\/\">API docs<\/a> for developers.<\/p>\n\n<!--section=installation-->\n<h4>From the Plugins Directory in WordPress Admin<\/h4>\n\n<p>From the \"Add Plugins\" page in WordPress admin:<\/p>\n\n<ol>\n<li><p>Search the plugins directory by <code>author: fontawesome<\/code><\/p><\/li>\n<li><p>Click \"Install\" on the Font Awesome plugin in the search results<\/p><\/li>\n<li><p>Click \"Activate\"<\/p><\/li>\n<\/ol>\n\n<h4>Installing a Zip Archive<\/h4>\n\n<ol>\n<li><p>Click Download on this plugin's directory entry to get the <code>.zip<\/code> file<\/p><\/li>\n<li><p>On the \"Add Plugins\" page in WordPress admin, click \"Upload Plugin\" and choose that <code>.zip<\/code> file<\/p><\/li>\n<\/ol>\n\n<h4>Access Font Awesome Plugin Settings<\/h4>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p><strong>Using Pro Icons and Features<\/strong>\nTo add icons using a Kit, create a <a href=\"https:\/\/fontawesome.com\/kits\">Kit on FontAwesome.com<\/a> and select \"Pro icons\" in the settings. Then grab your <a href=\"https:\/\/fontawesome.com\/account#api-tokens\">API Token from your Font Awesome account page<\/a> to add into the WordPress Kit settings.<\/p>\n\n<p>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 <a href=\"https:\/\/fontawesome.com\/account\/cdn\">Font Awesome CDN Settings page<\/a> and use shortcodes or HTML to add the icons into your content.<\/p>\n\n<p>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).<\/p>\n\n<!--section=faq-->\n<p>You can get more information about using the plugin, details for available settings, and answers to frequently asked questions on the <a href=\"https:\/\/docs.fontawesome.com\/web\/use-with\/wordpress\">WordPress docs on Font Awesome<\/a>.<\/p>\n\n<!--section=changelog-->\n<h4>5.1.4<\/h4>\n\n<ul>\n<li>Update the icon chooser package. This is only for compatibility with other tools that may be\nloaded on a page that also use the icon chooser package. It does not change how the icon chooser\nfunctions in this plugin.<\/li>\n<\/ul>\n\n<h4>5.1.3<\/h4>\n\n<ul>\n<li>Resolve a compatibility conflict with Toolset Types in the classic editor.<\/li>\n<\/ul>\n\n<h4>5.1.2<\/h4>\n\n<ul>\n<li>Fix a bug where clicking \"Style\" on a rich text icon (inside a paragraph block, for example), would\nresult in an error in the block editor. This bug was introduced in 5.1.1 and does not affect\nicons created as blocks--only those added as inline rich text.<\/li>\n<\/ul>\n\n<h4>5.1.1<\/h4>\n\n<ul>\n<li>Enable changing the icon within the block editor styling UI.<\/li>\n<li>Fix a bug in block editor icon styling UI where the theme color palette options were incorrect when\nany custom colors were defined in the theme.<\/li>\n<li>Fix animations on SVGs in some use cases when added in the block editor. This loads a different SVG\nsupport stylesheet that includes the animations CSS rules.<\/li>\n<li>Fix a bug where when there are multiple empty icon blocks, changing an icon in one might affect others.\nThe now function independently of one another as expected.<\/li>\n<\/ul>\n\n<h4>5.1.0<\/h4>\n\n<ul>\n<li>Minor updates to support Font Awesome 7.<\/li>\n<li>Allow kits to use a version \"7.x\".<\/li>\n<li>Update icon chooser to support Font Awesome 7.<\/li>\n<li>Use the new svg.css for SVG support styling. (Reverted in 5.1.1)<\/li>\n<\/ul>\n\n<h4>5.0.2<\/h4>\n\n<ul>\n<li>Fix a bug in the Classic Editor involving interaction with some other plugins, where the Font Awesome\nmedia button would not be visible.<\/li>\n<li>Make it an admin warning instead of an error when the plugin can't fetch SVG support stylesheet.<\/li>\n<li>Add a <code>font_awesome_disable_block_editor_support<\/code> filter to allow disabling the block editor support entirely.<\/li>\n<li>Changes to enable usage of the self-hosted SVG support stylesheet on systems where file system access is not available.<\/li>\n<\/ul>\n\n<h4>5.0.1<\/h4>\n\n<ul>\n<li><p>Automatically fetch the SVG stylesheet any time the WP admin dashboard or Font Awesome plugin settings\npage is loaded. This stylesheet is required for the new embedded SVG icons to display correctly when they\nare added using the Icon Chooser in the Block Editor. If you do not use the Block Editor, and do not want\nthis additional stylesheet to be loaded, you can disable it from loading by adding the following to\nyour theme's functions.php or equivalent:<\/p>\n\n<p><code>add_action(\"wp_enqueue_scripts\", function () {\nwp_dequeue_style(\"font-awesome-svg-styles\");\n});<\/code><\/p><\/li>\n<\/ul>\n\n<h4>5.0.0<\/h4>\n\n<ul>\n<li>Enhance support for the Block Editor. Add icons as blocks or as inline Rich Text using the\nIcon Chooser. Icons added in the Block Editor using the Icon Chooser are added as inline SVGs,\nand can be visually previewed, styled, sized, and animated within the Block Editor. This works\nfor pages, posts, and in the Full Site Editor.<\/li>\n<li>Improve Icon Chooser performance.<\/li>\n<li>Remove support for Font Awesome 3 icon names in the <code>[icon]<\/code> shortcode.<\/li>\n<li>Change minimum supported WordPress to 5.8.<\/li>\n<li>Change minimum supported PHP to 7.4.<\/li>\n<\/ul>\n\n<h4>4.5.0<\/h4>\n\n<ul>\n<li>Update the Icon Chooser to support all available family styles for the active version of\nFont Awesome. The available family styles are dynamically loaded so that when new\nfamily styles are introduced in new versions of Font Awesome, they will be immediately\navailable in the Icon Chooser.<\/li>\n<li>Make the Icon Chooser available in the Full Site Editor.<\/li>\n<li>Change the format of some network requests in order to accommodate common Web Application\nFirewall settings. This resolves a common cause of error messages, such as:\n\"Something has gone horribly wrong\" in the Icon Chooser, or \"Couldn't save those changes\" on\nthe plugin's settings page.<\/li>\n<\/ul>\n\n<h4>4.4.0<\/h4>\n\n<ul>\n<li>Update the Icon Chooser to fix the use of Sharp Solid in more recent versions of Font Awesome,\nand include Sharp Regular and Sharp Light.<\/li>\n<li>Add the \"defer\" attribute to script tags when in \"Use a Kit\" mode. This was already the behavior\nunder \"Use CDN\" mode.<\/li>\n<li>Fix some deprecation notices for php 8.2.<\/li>\n<\/ul>\n\n<h4>4.3.2<\/h4>\n\n<ul>\n<li>Security Fix: escape shortcode attribute values.<\/li>\n<\/ul>\n\n<h4>4.3.1<\/h4>\n\n<ul>\n<li>Increase network request timeout to accommodate some slow-running Icon Chooser searches.\nWe've recently added some new functionality to the Font Awesome API server. We're in\nthe process of optimizing it for performance. In the meantime, some icon searches that\nreturn lots of search results are running slowly. Increasing the timeout\nallows those searches to run longer before considering it an error.<\/li>\n<\/ul>\n\n<h4>4.3.0<\/h4>\n\n<ul>\n<li>Introduce support for Sharp Solid.\nThe Icon Chooser now includes Sharp Solid among the available styles when using\na Font Awesome Pro Kit.<\/li>\n<li>Introduce support for WordPress multisite. Allows installing the plugin network-wide\nand configuring each site separately.\nPrevious versions of this plugin were not compatible with multisite, though it was\npossible to install and get partial functionality on multisite. However, this\ncould also result in a confusing database state. If you're running multisite,\nit's important that any installation of a previous plugin version is totally cleaned\nup before trying to install this version. Upgrading on multisite without cleaning up\nfirst will probably result in an error. A previous installation can usually be\ncleaned up by deactivating and uninstalling it. Uninstall must be done by clicking\n\"Delete\" on the deactivated plugin's entry in the plugin list in the admin dashboard.\nIt may also work to install the previous 4.2.0 version and then uninstall it, just\nto get its cleanup code to run.\nThis has no impact on sites that are not running in multisite mode. If you're not\nrunning multisite, upgrading to this version should be smooth and problem-free.<\/li>\n<\/ul>\n\n<h4>4.2.0<\/h4>\n\n<ul>\n<li>Make Font Awesome 6 the default version on new activations.<\/li>\n<li>On the version selection dropdown, distinguish between the latest 5.x and the latest 6.x.<\/li>\n<li>Maintenance updates to JavaScript dependencies.<\/li>\n<li>Developers: the latest_version() method has been deprecated and replaced by two alternatives:\nlatest_version_5() and latest_version_6().<\/li>\n<\/ul>\n\n<h4>4.1.1<\/h4>\n\n<ul>\n<li>Simplified upgrade logic: makes the upgrade process on the first page load\nafter upgrade quicker and smoother.<\/li>\n<\/ul>\n\n<h4>4.1.0<\/h4>\n\n<ul>\n<li>Added support for using Font Awesome Version 6 Free with CDN. In order to use\nVersion 6 Pro with this plugin, it's still necessary to use a Kit,\nsince Version 6 Pro is not available on the classic CDN.<\/li>\n<li>Renamed the \"Version 4 Compatibility\" option as \"Older Version Compatibility\",\nsince compatibility features may now involve both Version 4 and Version 5.<\/li>\n<li>Updated version of the conflict detection script used when configured for CDN.<\/li>\n<li>FIX: in some cases, when running the conflict detector on the back end,\nthere was an error about an undefined variable called $should_enable_icon_chooser.\nFixed.<\/li>\n<li>FIX: in some cases, when running php 8.0 or higher, there was an error related to\ncalling method_exists(). Fixed.<\/li>\n<li><strong>Developers:<\/strong> The v4_compatibility() method has been deprecated and will be removed\nin a future release. It's now just compatibility().<\/li>\n<li><strong>Developers:<\/strong> The preference named \"v4Compat\" in the array argument to the register()\nmethod has been deprecated and renamed \"compat\". Any uses of \"v4Compat\" are automatically\ntranslated to \"compat\".<\/li>\n<li><strong>Developers:<\/strong> There are no breaking changes. Any code that uses the above deprecated\nfeatures will continue to work the same without modification in this release.<\/li>\n<\/ul>\n\n<h4>4.0.4<\/h4>\n\n<ul>\n<li>FIX: add hash values to JavaScript chunk file names to resolve the problem where\nsometimes an old cached version of a JavaScript file would load in the browser\ninstead of the intended updated one. This caused some users to see a blank\nsettings page after upgrading from a previous version of the plugin.<\/li>\n<\/ul>\n\n<h4>4.0.3<\/h4>\n\n<ul>\n<li>FIX: When in the Classic Editor in WordPress 5, do not load block editor\nscript dependencies that assign to the global wp.editor object.\nThis prevents problems with other plugins on the page that may depend on that\nglobal.<\/li>\n<li>FIX: When in the Classic Editor where multiple editor instances are present,\nensure that the Add Font Awesome media button on each is wired up to\nload the Icon Chooser on click, not just those buttons that were on the page\nat the time this plugin's initialization code is run.<\/li>\n<\/ul>\n\n<h4>4.0.2<\/h4>\n\n<ul>\n<li>FIX: re-enable the Icon Chooser in the Classic Editor on WordPress 4.<\/li>\n<li>FIX: in some cases where the path to the plugin was a non-standard\nlocation--such as when installed via composer--the admin settings page and\nIcon Chooser would not load correctly. Fixed.<\/li>\n<li>FIX: the global version of the lodash JavaScript library was again being overwritten\nby the version used by this plugin. Fixed.<\/li>\n<li>The Icon Chooser's integration with the Block Editor (Gutenberg) has been disabled\nfor Wordpress 5.0, 5.1, 5.2, and 5.3, due to incomptabile JavaScript libraries.\nAll other features of the plugin work normally on those versions, including\nIcon Chooser integration with the Classic Editor.<\/li>\n<\/ul>\n\n<h4>4.0.1<\/h4>\n\n<ul>\n<li>FIX: In scenarios where both Gutenberg (Block) and TinyMCE (Classic)\neditors were being loaded onto the same page, the Gutenberg editor was not\ndisplaying properly.\nNow, in that multi-editor situation, the Icon Chooser integration is only enabled\nfor the block editor.\nIn those cases, you can still use icon shortcodes or HTML in\nthe TinyMCE editor boxes; those editors just won't have the \"Add Font Awesome\"\nmedia button for opening the Icon Chooser.\nThe Icon Chooser is still available from the Classic Editor when the block editor\nis not present on the page.<\/li>\n<li>FIX: In scenarios where there are multiple TinyMCE editor instances on the same page,\nsuch as WooCommerce product editing pages, only the \"Add Font Awesome\" media\nbutton on the first of those editors was working correctly. Now all of them work\ncorrectly.<\/li>\n<li>FIX: In the Classic Editor, when other themes or plugins added media buttons after\nthe \"Add Font Awesome\" button, those buttons were showing up as combined together\nand not working properly. Now they're separated and working great.<\/li>\n<li>The Icon Chooser integration for the Classic Editor in WordPress 4 has been temporarily\ndisabled. Everything else works as before in WP4, just not the new Icon Chooser.<\/li>\n<\/ul>\n\n<h4>4.0.0<\/h4>\n\n<ul>\n<li>OFFICIAL 4.0.0 STABLE RELEASE<\/li>\n<li>FEATURES: Includes all the features from the early 4.0.0 release candidates (details below)<\/li>\n<li>FEATURE: Visual icon chooser lets you search and easily insert the correct shortcode.<\/li>\n<li>Fixed regression on overriding global lodash version.<\/li>\n<li>Added PHP API method to get current Kit token.<\/li>\n<li>Removed the filter to process all shortcodes in widget text. This seems to have been\nan overly eager approach on our part. If you want shortcodes to be processed\nin widget text - all shortcodes, not just this plugin's icon shortcode - you can\nadd a line like this to your theme's functions.php file:\n  <code>add_filter( 'widget_text', 'do_shortcode' );<\/code><\/li>\n<\/ul>\n\n<h4>4.0.0-rc23<\/h4>\n\n<ul>\n<li><p>FIX: plugin now handles Kits with version \"5.x\" or \"6.x\"<\/p><\/li>\n<li><p>FEATURE: shortcode supports attributes: style, role, title, aria-hidden,\naria-label, aria-labelledby<\/p><\/li>\n<\/ul>\n\n<h4>4.0.0-rc22<\/h4>\n\n<ul>\n<li><p>Metadata about available Font Awesome releases is now stored as a normal option\nin the WordPress database, instead of as a transient. Thus, it does not expire\nand does not disappear if the transient cache is purged.<\/p>\n\n<p>This is in part to avoid the scenario where a request to the Font Awesome API\nserver may be required to refresh metadata in response to a front end page load\nwhen that transient expires.<\/p>\n\n<p>Some site owners had occassionally experienced problems where a sudden burst of\nrequests to the API server from many WordPress sites caused this plugin to fail\nwhen making a request with an error like 'An unexpected response was received\nfrom the Font Awesome API server.' This change means that it is significantly\nless likely that such a scenario will occur.\n(Additionally, changes have been made on the API server, also making it\nsignificantly less likely that this over-load failure will occur again.)<\/p><\/li>\n<li><p>Developers: the refresh_releases() API method has been deprecated to discourage\nunnecessary blocking network requests to the API server.<\/p><\/li>\n<\/ul>\n\n<h4>4.0.0-rc21<\/h4>\n\n<ul>\n<li>optimize normal page loads by loading much less metadata from the database (GitHub #96)<\/li>\n<li>move the Font Awesome settings link from the main admin nav menu back down under Settings, where it used to be<\/li>\n<li>update the version of the conflict detection script to one that also detects conflicting Kits<\/li>\n<li>minor maintenance changes to keep JavaScript dependencies up to date<\/li>\n<li>fix a bug involving the pseudo-elements setting when moving back and forth between using a Kit and using CDN (GitHub #82)<\/li>\n<\/ul>\n\n<h4>4.0.0-rc20<\/h4>\n\n<ul>\n<li>developer-oriented update to support building themes that use this code as a composer package<\/li>\n<\/ul>\n\n<h4>4.0.0-rc19<\/h4>\n\n<ul>\n<li>another minor update with additional error logging<\/li>\n<\/ul>\n\n<h4>4.0.0-rc18<\/h4>\n\n<ul>\n<li>minor update with additional error logging<\/li>\n<\/ul>\n\n<h4>4.0.0-rc17<\/h4>\n\n<p><strong>SECURITY:<\/strong> fixes a vulnerability in how API tokens were being stored, when configured to use a Kit. All users of 4.0.0-rc15 or 4.0.0-rc16 should update immediately. Find more details and instructions for updating your API Token on the <a href=\"https:\/\/blog.fontawesome.com\/font-awesome-wordpress-plugin-api-token-vulnerability-fixed\">Font Awesome blog<\/a>.<\/p>\n\n<ul>\n<li>a minor bug in how network errors are handled<\/li>\n<\/ul>\n\n<h4>4.0.0-rc16<\/h4>\n\n<ul>\n<li>Fixes to the upgrade process<\/li>\n<\/ul>\n\n<h4>4.0.0-rc15<\/h4>\n\n<p><strong>MAJOR UPDATE<\/strong>, some breaking changes for developers. Improves conflict detection, adds support for Kits and internationalization.<\/p>\n\n<ul>\n<li>Includes auto-upgrade logic so that most users can upgrade with no impact, except those that have \"registered client\" themes or plugins. Users who had previously enabled the \"remove unregistered clients\" option should verify that the auto-upgrade worked successfully - check that your icons are appearing correctly. If not, run the Conflict Scanner from the Troubleshoot tab.<\/li>\n<li>New conflict detection and resolution: The new conflict detection scanner can be enabled to more precisely discover conflicting versions of Font Awesome and provides more granular conflict resolution.<\/li>\n<li>Expanded error handling with detailed reports in the web console for more advanced diagnostics.<\/li>\n<li>Adds support for Kits.<\/li>\n<li>Adds comprehensive internationalization in both PHP and JavaScript.<\/li>\n<li>New design of the admin UI.<\/li>\n<li><strong>Developers:<\/strong> Significant changes to the way the settings are handled internally: Font Awesome will always load in the way the WordPress admin chooses. Registered themes or plugins may register preferences (which are displayed to the admin), but the site admin will determine the configuration.<\/li>\n<li><strong>Developers:<\/strong> Registered client plugins and themes need to be updated before they will work as expected.<\/li>\n<li><strong>Developers:<\/strong> The PHP API contains significant changes. See the GitHub <a href=\"https:\/\/github.com\/FortAwesome\/wordpress-fontawesome\/blob\/master\/README.md\">README<\/a> for an overview and the <a href=\"https:\/\/fortawesome.github.io\/wordpress-fontawesome\/\">PHP API docs<\/a> for details. <em>This release is intended as a final API-changing release before stabilizing the API at 4.0.0. Once 4.0.0 is released, it will follow semantic versioning best practices.<\/em><\/li>\n<\/ul>\n\n<h4>4.0.0-rc13<\/h4>\n\n<ul>\n<li>Improve diagnostic output for unhandled errors.<\/li>\n<\/ul>\n\n<h4>4.0.0-rc12<\/h4>\n\n<ul>\n<li>Bug fix: Fix loading of admin page assets when removal of unregistered clients is enabled. This bug has been\nhiding under a rock for a while. rc11 turned over the rock, and this bug scurried out.<\/li>\n<\/ul>\n\n<h4>4.0.0-rc11<\/h4>\n\n<ul>\n<li>Bug fix: enqueue Font Awesome assets in admin and login areas, not just in the front end<\/li>\n<\/ul>\n\n<h4>4.0.0-rc10<\/h4>\n\n<ul>\n<li>Attempt to fix a problem where the admin settings is sometimes being confused by unexpected output from the WordPress\nserver. This condition has been reported when certain other plugins are active, and (possibly) when PHP output\nbuffering works differently than this plugin expects.<\/li>\n<\/ul>\n\n<h4>4.0.0-rc9<\/h4>\n\n<ul>\n<li><p>Enhance Font Awesome version 4 compatibility: add shimming of the version 4 font-family to enable version 4\nicons defined as pseudo-elements to be rendered via the version of Font Awesome 5 loaded by this plugin.<\/p><\/li>\n<li><p>Add warnings to the admin UI to indicate that using svg and pseudo-elements may result in slow performance,\nand that svg with pseudo-elements and version 4 compatibility is not supported at all.<\/p><\/li>\n<\/ul>\n\n<h4>4.0.0-rc8<\/h4>\n\n<ul>\n<li><p>Remove dependence on third party libraries, eliminating a class of potential conflicts with other plugins.<\/p><\/li>\n<li><p>Breaking changes to the API used by theme and plugin developers (no breaking changes for WordPress site owners).\nSee <a href=\"https:\/\/github.com\/FortAwesome\/wordpress-fontawesome\/commit\/80f973b4a0f6ac09cbb4dc3ecc1ae2964ef01d32\">commit log<\/a><\/p><\/li>\n<\/ul>\n\n<h4>4.0.0-rc7<\/h4>\n\n<ul>\n<li>Fix detection and removal of unregistered clients by changing the internal resource name this plugin uses to enqueue its resource.\nChange it to something unlikely to be used by other themes or plugins.<\/li>\n<\/ul>\n\n<h4>4.0.0-rc6<\/h4>\n\n<ul>\n<li>Fix error when updating options on admin page: handle null releaseProviderStatus in cases where the release provider\ndoes not have to make a network request to update release metadata.<\/li>\n<\/ul>\n\n<h4>4.0.0-rc5<\/h4>\n\n<ul>\n<li>Remove tilde character from JavaScript filenames to avoid violating some URL security rules<\/li>\n<\/ul>\n\n<h4>4.0.0-rc4<\/h4>\n\n<ul>\n<li><p>Cache releases data in the WordPress database to reduce the number of server-side network requests.<\/p><\/li>\n<li><p>Ensure that releases data are always loaded fresh from fontawesome.com when loading the admin\nsettings page so site owners can see when new versions are available.<\/p><\/li>\n<li><p>Add more specific error message on admin dashboard in the event that the WordPress server is not able to\nreach fontawesome.com in order to get an initial set of available releases data.<\/p><\/li>\n<\/ul>\n\n<h4>4.0.0-rc3<\/h4>\n\n<ul>\n<li>Add missing v3 shim file<\/li>\n<\/ul>\n\n<h4>4.0.0-rc2<\/h4>\n\n<ul>\n<li>Fix handling of v3 deprecation warnings in admin settings page<\/li>\n<\/ul>\n\n<h4>4.0.0-rc1<\/h4>\n\n<ul>\n<li>Add admin settings page<\/li>\n<li>Lots of back end code changes to support theme and plugin developers\n\n<ul>\n<li>Package plugin as a composer dependency<\/li>\n<li>API Changes<\/li>\n<li>Comprehensive API documentation for developers<\/li>\n<\/ul><\/li>\n<li>Cache load specification unless client requirements change<\/li>\n<li>Handle changing configurations as new plugins or themes are activated, de-activated or updated<\/li>\n<li>Lock working load specifications and only rebuild when new requirements are conflict-free<\/li>\n<li>Load Font Awesome release version metadata from the fontawesome.com releases API<\/li>\n<\/ul>\n\n<h4>3.2.1<\/h4>\n\n<ul>\n<li>Last stable version of the old plugin<\/li>\n<\/ul>","raw_excerpt":"The official way to use Font Awesome Free or Pro icons on your WordPress site, brought to you by the Font Awesome team.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/687","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=687"}],"author":[{"embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fontawesome"}],"wp:attachment":[{"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=687"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=687"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=687"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=687"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=687"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/eo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=687"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}