Blog
AI Agent Tools Page
Our AI agent tools have a page of their own, linked from the main nav, with everything you need to get set up.
Head to AI Agent Tools to set up your agent in one step, see what you can ask it, and connect it to your Kits.
Platform License
A new Platform License lets the people using your CMS, page builder, app, or plugin pick and use Pro icons inside it.
Building a product where your own customers choose icons? This one's for you. Owners, admins, and billing contacts on a paid plan can request one from the Platform License page.
Changelog Feed
Follow the changelog in any feed reader, and AI agents can now read our key pages as markdown.
You no longer have to remember to check back here. The changelog now comes to you, and it's easier for your tools to read too.
- Subscribe in any feed reader. Every new release and website update now has an RSS feed you can follow. Add it to your feed reader, and new entries show up with their full notes and working links. Look for the Subscribe link under the months on this page.
- Readable by AI agents. This page and our license, plans, privacy, and refunds pages are also published as markdown, so an assistant asked about Font Awesome gets the real answer instead of a blank page.
Add Kits, Pageviews, and More Without Upgrading Your Plan
Random Content, On Purpose
Plan Add-ons
Add Kits, custom icons, pageviews, bandwidth, or seats to your plan without changing plans.
Need a little more room without moving to a bigger plan? Head to the Add-ons page. Every change lands in one order summary with one checkout, and you can scale an add-on back at renewal. You'll also see the option right when you hit a limit.
Good News: Your AI Assistant Already Knows Your Icon Kit
Icon Wizard Duotone
The Icon Wizard now makes duotone icons, with multi-layer select and undo history.
The Icon Wizard just learned a second color, and picked up a few other tricks along the way.
- Duotone icons. Split your creation into two tones and watch it render like every other Duotone icon in the library.
- Multi-layer select. Grab several layers at once and move or duplicate them together, instead of one at a time.
- Better controls. Type an exact value and send any control back to its default with a single click.
- Nudge UI. New arrows around the canvas shift the selected layer without reaching for the keyboard.
- Undo history. Wandered down the wrong path? Step back through your changes until it looks right again.
Your Design System Should Style Your Words, Too
Icon Search Redesign
Icon search is rebuilt with a pack rail, a tighter grid with hover actions, and search that understands plain-language descriptions.
Icon search has been rebuilt around the thing you actually came for: finding the right icon, fast.
- A rail down the side gives every pack its own place, so you can jump straight to Classic, Sharp, Duotone, or any of the Pro+ packs and see that pack on its own. Styles sit right above the results, one click away.
- The grid is tighter and quicker to scan, with bigger icons, less space between them, and the actions you want on a cell (copy the markup, grab the SVG, drop it in a Kit) right there when you hover.
- Filtered yourself into a corner? If your icon lives in a different pack, a different plan, or another category, you'll see it in its own section under the results, with a one-click way to go there.
- When nothing matches at all, you get four ways forward instead of a dead end.
- Search now reads for meaning, not just wording, so describing what you need in plain language can turn up icons that never use your exact words.
Kit Package Rebuilds
Rebuild a Kit's package yourself from its Package view, instead of asking Support.
If your Kit's package looks stale or broken, rebuild it yourself from the Kit's Package view. It's the digital equivalent of turning it off and on again, and you no longer need to ask us to do it for you. Find it in your Kits.
The Art of Iconography and How to Future-Proof Your Design System [Part IV]
WA 3.12: Figma Design Kit 3.0, Dropdown Links, Plus Tooltip Fixes
How Does Web Awesome Stack Up Against Shoelace?
How to Build and Style Your Visual Design System [Part III]
The New Icon Wizard: Build an Icon Nobody’s Ever Made
Icon Wizard 2.0
Icon Wizard 2.0 lets you combine and remix icons, build custom characters, and add your creations straight to a Kit.
A wizard arrives precisely when he means to, and Icon Wizard 2.0 has arrived. Combine and remix icons into something all your own: stack on modifiers and elements, or conjure a custom character in the User Blender. Then drop your creation straight into your Kit, download it, or share it with a link. Try the Icon Wizard or read the docs.
WA 3.11: Data Grid, New Components, Plus Free Toast
Copy and Move Custom Icons
Copy or move custom icons from one Kit to another, one at a time or in bulk.
Custom icons aren't stuck in the Kit you uploaded them to anymore. Copy or move one from its detail view, or select a batch on the Custom Icons tab and move them all at once. No downloading and re-uploading required. Try it from your Kits.
The Building Blocks of a Visual Design System [Part II]
7.3.1
New icons, plus fixes for brand icons missing from Free and a few 7.3.0 icon glitches.
Added
-
New Icons!
It's game on with new sports icons:
padel,padel-ball,cricket-bat,field-hockey-stick, andtable-tennis-paddle.
Fixed
- These new brand icons were introduced in 7.3.0 but were mistakenly excluded from Font Awesome Free:
visual-studio,dolibarr,obs-studio,storybook,a11y-project,copilot. Those responsible have been sacked, and the icons have been freed. - The new
meerkaticon in 7.3.0 somehow got a capitalized name alias of "Suricata", though all names are supposed to be lowercase. - Some new Slab Duo icons looked already-pressed in 7.3.0, like their Slab Press Duo counterparts:
box,bug. They've been un-pressed. - The primary and secondary layers for the
gearicon in Jelly Duo Regular were swapped. - These seal icons were redesigned and rotated:
seal,seal-exclamation,seal-question.
Changelog Refresh
The changelog gets a month-by-month sidebar, type filters, and website updates alongside Icon Library releases.
We're going full inception on this one and posting a changelog entry about a change to our changelog. Among the changes:
- A month-by-month sidebar
- Filter changelog entries by type: All, Icon Library, or Website
- Website updates now share the feed with the Icon Library
- Tooting our own horn just got easier
New Plans
Three new plans, Starter, Solo, and Team, with nothing changing for current subscribers.
We've simplified our plans to better fit how folks actually use Font Awesome, whether you're one person with a side project or a whole team shipping constantly. The new lineup: Starter, Solo, and Team. Details on our plans page.
Already a subscriber? Nothing changes for you. Your current plan stays exactly as it is. Same price, same limits, same features. Questions? We've got answers.
Bulk Icon Import
Paste a list of icon names to add them all to a Kit at once, with typos flagged before you import.
Bringing an existing icon list to a Kit used to mean adding icons one at a time. Now hit Import Icons on your Kit, paste the list (one name per line, and don't sweat stray fa- prefixes or quotes), preview the matches, fix any typos we flag, and add the whole batch in one go. One paste instead of 750 clicks. Your mouse thanks you.
Homepage Redesign
A redesigned homepage with a faster path to icon search, plans, and the rest of the site.
It's cleaner from top to bottom. Come on in and wipe your feet, the welcome mat's brand new. Take it for a spin on the homepage.
Icon Animations and Padding
The icon detail page adds flip, buzz, float, jello, swing, and wag animations, plus square and roomy padding controls.
The icon detail page picked up a batch of new animations, including flip, buzz, float, jello, swing, and wag (tail not included). There are also new padding controls for square and roomy canvases, because even icons appreciate a little personal space. Every option applies live to the preview and drops straight into your code snippet. Try them from any icon in icon search.
7.3.0
Three new Pro+ packs (Pixel, Mosaic, and Vellum), Slab Duo styles, and six new animations.
Added
-
Three new Pro+ icon packs!
- Pixel: It's hip to be square. Before high density displays, the mighty pixel was king. FA Pixel takes you back to the halcyon days of yore, when quarters held your place at the arcade and computers only had 128kb of memory. If you're prepping your next plumbing adventure or space invasion, Pixel is ready to byte.
- Mosaic: All the pieces are coming together. Icons are little art pieces constructed from many elements, and FA Mosaic is no different. Master craftsman Josh Williams breaks the mold with this pack, blending solid forms, swoopy curves, and fun little sprinkles he lovingly calls "quirks."
- Vellum: Layers of depth. Here at Font Awesome, we like our icons like we like our jokes: layered. Guest designer Brian Brasher guides you amongst these overlapped slabs of significance for a pack with real dimension.
- Each pack is available with a Pro+ subscription.
-
New Slab styles!
- Our sturdy, blocky Slab pack gets two new family styles: Slab Duo and Slab Press Duo. Add some depth and a second layer of color to icons that feel bold and ready for action.
-
New animations!
- Inspired by Disney's 12 Principles of Animation, we added six new animation utilities so your icons don't just move, they have personality:
fa-buzz,fa-wag,fa-float,fa-swing,fa-spin-snap(withfa-spin-snap-4andfa-spin-snap-8variants), andfa-jello. - Each new animation follows our existing custom property naming convention and works out of the box without setting any properties.
- All animations continue to respect the
prefers-reduced-motionsetting. - See them all in action in the animation documentation.
- Inspired by Disney's 12 Principles of Animation, we added six new animation utilities so your icons don't just move, they have personality:
-
New canvas sizing classes!
- Two new opt-in utility classes let you drop any icon onto a predictable, square canvas, perfect for icon-only buttons and design-system layouts.
fa-canvas-squareadds vertical padding so an icon fills a square canvas (20×20 at 1em).fa-canvas-roomyadds a bit more padding for layouts that want extra breathing room (24×24 at 1em).- Both use
emunits, so the canvas scales right along with your icon size.
-
New Icons!
A few fresh additions to the family:
envelope-heart,file-md,file-txt, andmeerkat. -
New Brands!
Added a batch of the most-requested brand icons:
a11y-project,build-awesome,square-build-awesome-stroke,codeberg,copilot,devpost,dolibarr,internet-archive,lets-encrypt,matrix,mattermost,nextcloud,obs-studio,roblox-creator-studio,ror,storybook,substack,tesla,visual-studio,xrp,xrpl, andyoutube-shorts.
Changed
- Better motion for existing animations. We refined the keyframes for six of our existing animation utilities for motion that feels more alive:
fa-bounce,fa-beat,fa-beat-fade,fa-fade,fa-flip, andfa-shake. Same class names, same custom properties, just better motion. - Brand refreshes. Updated a few brand icons to match their latest logos:
githubfor GitHub's 2026 brand refresh,androidto match current brand standards, andthreadsfor Threads' updated logo.
Fixed
- The Etch
circle-questionicon wasn't quite right. It is now. - The solid and regular styles of
fingerprintwere identical. They're now their own unique selves. - Cleaned up some inconsistencies between the solid
boxicons. - Fixed a vertical misalignment on the solid
battery-emptyicon. - The Duotone Thin
game-board-simpleicon had a secondary tone spilling outside the lines. We tidied it up. - The Duotone Light
opossumicon wasn't actually duotone. Our 'possum now has two tones, as nature intended. - The Duotone
toolboxicon was showing just the line art for its fill. The fill is back where it belongs.
Plan Changes
Switch plans, billing cycles, or seat counts from the plans page, with a price preview before you commit.
Changing plans no longer sends you off to a separate billing portal. Start from the plans page. Upgrades start right away, and downgrades wait for your renewal date.
Account Deletion
Paid, lapsed, and team accounts can now be deleted from account settings, without contacting Support.
We'll be sad to see you go, but leaving shouldn't take a support ticket. Start from account settings, and we tell you exactly what goes with it first, including your teammates' accounts if you're a team owner.
Kit Bandwidth Usage
Track your Kit's CDN bandwidth over time from the Tokens tab in your account.
Keeping an eye on usage no longer requires a support ticket or a crystal ball. Find it on the Tokens tab.
Kit Page Redesign
The Kit page is reorganized into three tabs, with settings and downloads in quick drawers and the embed code always in view.
We tidied the whole Kit page around what you use most. Five tabs are now three (Icons, Custom Icons, and Configure), settings and downloads tucked themselves into quick topbar drawers, and your Kit's embed code now sits above the tabs, always one copy away. Everything in its place, and not a single sock drawer in sight. Check it out on your Kits.
Cancellation Flow
Canceling now shows exactly what changes at renewal and offers alternatives like switching plans.
We reworked subscription cancellation into a two-screen flow that shows exactly what changes at your renewal date, offers alternatives like switching plans or getting help, and asks a quick optional reason if you do decide to cancel. You'll find it under billing in your account.
Account Features Token Scope
API tokens can now read which features your account includes, without broader access.
Add the Allowed account features scope to a custom token from the Tokens tab. Strictly need-to-know basis, as the spies say.
New Sponsorship Tiers for the Build Awesome Kickstarter
Replace Custom Icons
Swap a custom icon's SVG in place, keeping its name and every reference to it.
Need to update a custom icon? Pull a Freaky Friday and swap its SVG in place. Same name, same references, and your live sites never notice the switch. No more delete-and-re-upload dance. Learn more about working with custom icons.
Overage Warnings
Your account now shows a banner when Kit pageviews or bandwidth run over your plan, with a clearer breakdown on the billing page.
We've always let you know when your usage is heading past your plan's limits, and now you'll see it in your account too. Check the breakdown on your billing page. Surprises are for birthdays, not bills.
Icon Descriptions
Icon pages now describe what each icon shows, brand icons included.
Every icon page now has a short description of what the icon shows, just below its tags. Brand icons got theirs too. Handy when you're choosing between two lookalikes, or writing alt text. Browse them in icon search.
Add to Kit from Search
Collect icons in a tray while you browse search, then add them all to a Kit in one go.
See an icon you like? Hit the plus button to toss it in the tray and keep browsing. Gotta catch 'em all? Now you actually can. Try it from icon search or any icon category page.
Kit Creation Wizard
Making a Kit now takes two steps, with a one-click Quick Start for anyone who wants to get going right away.
Making a new Kit got a lot shorter. Choose Quick Start and you're done in one click, or pick your styles and delivery method yourself in two steps. The package option moved to the final step, right where you'd look for it. Start one from your Kits.
Back Build Awesome Pro and make it easier to build for the web!
Collaborative Editing as Progressive Enhancement
CLI Sign-in
Sign in to the fa command-line tool from your browser, with no tokens to copy and paste.
It uses the OAuth 2.0 device flow, so your clipboard gets the day off. See the Font Awesome packages docs to get set up.
The Possum Mascot, now with additional Awesome
AI Agent Tools
Official agent tools let Claude Code, Cursor, Copilot, and other AI assistants set up Font Awesome, suggest icons, and add them to your project.
Your AI coding assistant can now speak fluent Font Awesome. The docs got agent-friendly too, with a Markdown version of every page. These are the droids you're looking for, and they start in the AI agent tools docs.
Eleventy is now Build Awesome
Product Navigation
A new top nav lets you jump between Font Awesome, Web Awesome, and the rest of the family from anywhere on the site.
Font Awesome is more than one product these days, so the navigation now spans all of them. No fellowship required.
Icon Colors
Preview every icon in any color, then download it as a PNG or SVG in that color.
Pick a color from icon search or the icon detail view to preview every icon in that shade, then download any icon as a PNG or SVG in your chosen color.
Rename Custom Icons
Give any custom icon you've uploaded to a Kit a new name.
Named an icon final-final-v2 in a hurry? Open the Kit and give it the name it deserves.
7.2.0
A new Pro+ pack, Graphite, plus moon phase icons, zodiac symbols, new brands, and brighter sun icons.
Added
-
New Pro+ icon pack: Graphite!
- A brand new hand-drawn Pro+ icon pack from designer Vic Bell. Featuring over 200 of the most commonly used icons for app and website design, Graphite is a fantastic new additon to the Font Awesome family.
-
New Icons! You voted. We listened. FA now includes:
- A bunch of new file icons like
file-css,file-html,file-icns, andfile-js. - Some new API and system icons like
gear-api,gear-complex-api,rectangle-api,rectangle-irc,rectangle-n-a,gpu,nas,input-password,globe-www,link-broken,image-broken,remote,rows-3, andtower-receive. - Fancy new table and layout icons like
table-cells-merge,table-cells-split,table-columns-add-after,table-columns-add-before,table-columns-merge-next,table-columns-merge-previous,table-columns-remove-after,table-columns-remove-before,table-rows-add-above,table-rows-add-below,table-rows-merge-next,table-rows-merge-previous,table-rows-remove-above,table-rows-remove-below, andtable-slash. - Icons to help you jump forward and backward in time like
arrow-rotate-left,arrow-rotate-left-15,arrow-rotate-left-30,arrow-rotate-right,arrow-rotate-right-15, andarrow-rotate-right-30. - A few additions to our activity icons like
bow-archery,arrow-archery,canoe-person,kayak,oar, andoars. - Some comfortable new furniture icons like
table-bar,desk,dresser,chest-drawers,stool,wardrobe, andtable-dining. - A grab-bag of additional icons like
label,layer,utility-can,owl,bicep,poker-chip,burst-new, andrectangle-new.
- A bunch of new file icons like
-
Moon phase icons! A full series of moon phase icons:
moon-new,moon-waxing-crescent,moon-first-quarter,moon-waxing-gibbous,moon-full,moon-waning-gibbous,moon-last-quarter, andmoon-waning-crescent. -
Zodiac symbols! 12 new Zodiac symbols:
aries,taurus,gemini,cancer,leo,virgo,libra,scorpio,sagittarius,capricorn,aquarius, andpisces. -
New Brands! Added a whole slew of the most-requested brand icons, including:
arch-linux,forgejo,gitee,kubernetes,postgresql,scaleway,solana,svelte,tailwind-css,typescript,vim, andxmpp.board-game-geek,circle-zulip,fediverse,globalleaks,hugging-face,ko-fi,openstreetmap,symfonycasts,threema,zoom, andzulip.claude,julia,leetcode,obsidian,square-deskpro,ultralytics,ultralytics-hub,ultralytics-yolo,unison, andunreal-engine.venmoandvenmo-v.
-
An Awesome 'Possum! And last, but not least, an
opossumicon.
Fixed
- Adjusted the placement of the plus, minus, and xmark on our
user-plus,user-minus, anduser-xmarkicons to be more legible at smaller sizes. - The rails on our Duotone
train-trackicons were mistakenly under the sleepers. We apologize to any trains that may have tried to use them. They've been fixed. - Some of the Sharp versions of our
helmet-safetyicon had round corners. No longer!
Changed
- Here comes the sun. Listen. Our old sun icons looked more like a gear than a sun. We're sorry about that. We updated all of our sun icons to shine a bit brighter:
cloud-sun,cloud-sun-rain,clouds-sun,eclipse,moon-over-sun,sun,sun-bright,sun-cloud,sun-dust,sun-haze,sunrise, andsunset. - Reverted the
chalkboard-usericon to it's v6 design to better match the standardchalkboardicon.
Eleventy, 2025 in Review
Eleventy Core Dependency Watch (2025 Edition)
Icon Leaderboard
Icon requests now live in GitHub Discussions, and the Icon Leaderboard ranks them by upvotes.
Want an icon we don't have yet? Upvote it on the Icon Leaderboard, and the most wanted icons rise to the top. The request FAQs moved there too, so the answers sit right next to the votes. Democracy, but for icons.
Securely Publishing our Packages to npm
Kit Downloads Token Scope
A new Kit downloads scope lets API tokens download your Kits, so builds and scripts can fetch them without you.
API tokens can now include a Kit downloads scope, so your build pipeline or deploy script can grab a Kit on its own. Robots love a download link. Set it up from the Tokens tab in your account.
The Eleventy Community Survey (2025)
Email Preferences
Turn our marketing emails on or off from your account settings, without missing account emails.
Pick the emails you want from the Email Preferences section of your account settings. Unsubscribing from marketing emails never stops the important ones, like password resets and overage alerts, so you won't miss anything that matters.
Teams
Invite teammates to your account and give each one a role: owner, admin, editor, or billing.
Font Awesome is better with friends. Invite teammates from the Team tab in your account, and they get their own sign-in on your plan. No more passing one password around the office.
- Owners have full control and can make another teammate an owner.
- Admins can do everything an owner can, except make someone an owner.
- Editors manage Kits and tokens, but not billing or the team.
- Billing folks handle invoices and payments, and nothing else.
How We Use GitHub Issues and How That’s Changing
Web Awesome Snippets
Icon detail pages now include a Web Awesome code snippet alongside HTML, React, Vue, and SVG.
Drop any icon straight into your Web Awesome project. Copy, paste, awesome. Pick an icon from icon search to grab one.
7.1.0
A new Pro+ pack, Utility, plus new icons and caret icons back at their version 6 size.
Added
-
New Pro+ icon pack: Utility!
- The new pack offers a curated set of the 200 most commonly used icons for app and website design. Available with a Pro+ subscription.
- Now available in 3 families: Utility, Utility Duo, and Utility Fill.
-
We added some new icons, including:
- the
tor-browserlogo, - a compelling new
pump-impellericon, - a gnarly new
hand-shakaicon, - a weighty new
kettlebellicon, - a mercurial new
foot-wingicon, - a collared new
chemexicon, - and an im-press-ive new
aeropressicon.
- the
Fixed
- Fixed a number of icon-related issues:
- Removed some errant vertices in the Light style of our
certificateicon. - Re-filled the heads of the people in Solid and Duotone styles of our
screen-usersicon. - Actually unlocked the lock of our
school-unlockicon in Duotone Solid and Sharp Duotone Solid.
- Removed some errant vertices in the Light style of our
Changed
- Reverted our
careticons back to smaller Version 6 proportions, and added newcaret-largeicons.
7.0.1
Clearer check and exclamation icons, new icons, and fixes for Safari and desktop fonts.
Added
- Introduces CSS custom property
--fa-widthfor standardized width management in stacked icons. - We added some new icons, including:
- a juicy new
lycheeicon, - a fancy new
envelope-ribbonicon, - a neighborly new
mailbox-open-emptyicon, - a freshly delivered
mailbox-open-lettericon, - a chunky new
tank-recoveryicon, - a zappy new
transducericon, - and a nosy new
box-magnifying-glassicon.
- a juicy new
Fixed
- Fixes a Regular Expression that caused errors in older versions of Safari when using SVG JavaScript pseudo-elements.
- Fixes content alternative (when using the
content: var(--fa)CSS attribute) with Safari 14.1 specifically (and maybe others) by adding@supportsto target browsers that support it. - Fixes a Windows font family grouping problem when using OTF Desktop files.
- Fixes style-only (no family specified) icon CSS classes not rendering icons when using
dom.watch(). - Fixed a number of icon-related issues:
- Fixed issue with where our
betaandrectangle-high-dynamic-rangeicons were missing some Duotone fills. - Fixed a missing cutout in the Solid styles of our
screwdriver-wrenchicons. - Our new
stadiumicon in Sharp Solid was showing the wrong style. - Our
pencil,pencil-line, andmotorcycleicons had the wrong fills in some Duotone styles. - The
cheese-swissicon had a few too manyholesglitches. - Fixed our Duotone
mangoicon. - Fixed issues with our
box-arrow-down-magnifying-glassandbox-arrow-down-arrow-upicons. - Removed extra bars in our
signal-weakicon. - Fixed a missing fill in the Regular style of our
dot-circleicon. - Fixed issues with
envelope-open-dollar,filter-circle-dollar, andfilter-circle-xmark.
- Fixed issue with where our
Changed
- Solved the case of the shriking checkmarks and adjusted the sizing and legibility of all of our icons that contain a
check. - Took a similar approach and tweaked the design of our
exclamationicons. - Updated the design of our
stretchericon to look more like a stretcher. - Adjusted the design of our
peruvian-solesicons to remove the outdated dot. - Remapped the design of our
oil-temperatureicon to a newwater-temperatureand redesigned the original.
7.0.0
Font Awesome 7: redesigned core icons, 300+ new icons, seven new Pro+ packs, and smaller, faster files.
Added
-
Introducing Font Awesome 7!
- The next version of the internet's favorite icon library and toolkit has arrived. It includes more icons, improved performance, and new ways to make your designs look amazing.
- Redesigned core icons. We've refined the majority of our core icons with more consistent key shapes.
- 300+ new icons. This first release of Font Awesome 7 delivers a large batch of fresh icons, with more coming soon.
-
New Pro+ icon packs!
- Each pack offers a curated set of the 200 most commonly used icons for app and website design. Available with a Pro+ subscription.
- Now available: Chisel, Etch, Jelly, Notdog, Slab, Thumbprint, and Whiteboard.
- Additional icon packs are on the way.
-
Icon Wizard improvements!
- A wizard is never late, nor is he early, he arrives precisely when he means to.
- Now includes over 40 modifiers.
- Option to place modifiers in the bottom-right or bottom-left corner.
- Turn any modified icon into a Duotone icon.
Changed
- Design improvements to the majority of our core icons.
- Massive improvements to SVG/JS pseudo-elements performance.
- Significantly smaller webfonts due to higher Brotli compression, a switch to CFF and various other optimizations.
- Smaller CSS files by using custom properties and optimizing the files for better compression.
- Upgraded to Dart Sass with modern SCSS and improved CSS properties.
- Improved naming and consistency of CSS custom properties.
- Use of CSS Logical Properties to support RTL languages and diverse writing modes.
- Icon canvases now render at a consistent fixed width. To use the default rendering from v6, add our new
fa-width-autoclass. - We've added mapping support for renamed CSS custom properties and SCSS variables to help existing projects using FA5 or FA6 work seamlessly with FA7.
- We have changed how our individual SVG files are formatted in FA7:
- No longer include a global stylesheet
pathelements no longer have classes on them- They default to
fill=currentColor - Duotone path color and opacity can be set using
--fa-primary-opacity,--fa-primary-color, etc.
- We removed some redundant icon designs, and remapped them as
aliases:user-large[-slash]→user[-slash]hexagon-vertical-nft-slanted→hexagon-vertical-nftheadphones-simple→headphonestoilet-paper-blank[-under]→toilet-paper[-under]vector-[shape]→draw-[shape]film-simple→filmgrid-horizontal→griphandshake-simple[-slash]→handshake[-slash]
- If you have custom CSS that selects the
.fa-primaryor.fa-secondaryclasses on SVG path elements, they'll no longer be present in FA7. Use the CSS custom properties to set opacity and color. - Changed SVG stringification on the Kits CDN. Most importantly, duotone icons must now be parsed based on the presence of an
opacityattribute with a value less than1, rather than relying on earlier structural patterns. - We are no longer including legacy
.ttfor.woffwebfonts. If your project depends on those files, please update to use the.woff2format, which is now the standard for webfont delivery. - We removed the
sr-onlyclasses, as Font Awesome's built-in accessibility doesn't use this approach anymore. If you were using them in your code, make sure you addsr-onlystyles to your own stylesheet. - We removed the
fa-fwclass, as it is no longer needed with the new default fixed-width rendering. If you were using it, you can now use the newfa-width-autoclass to revert to the previous behavior. - We have removed support for Less CSS in FA7. If your project uses Less, we recommend migrating to Sass, using our precompiled CSS, or continuing with Font Awesome 6.
- We have dropped support for our official Python Django plugin. If you were using it, you can either continue with Font Awesome 6 or switch to a self-hosted Kit or our standard CSS.
- We have ended support for the official Ruby on Rails Gem. Projects using it can continue with Font Awesome 6 or migrate to using a Web Fonts-based Kit or a self-hosted Kit.
- Our official Vue component now supports Vue 3+ only. Compatibility with Vue 2 or earlier is no longer guaranteed in FA7.
- The React component no longer supports dynamic imports. If you were importing icons dynamically, you'll need to update your syntax to use static imports for compatibility with FA7.
Fixed
- Improved support for screen readers and assistive technologies.
- Updated accessibility documentation and guidance to align with current best practices.
- Downloaded SVGs now default to a square viewbox, with an option to download a trimmed version.
- Since SVG icons now get a
currentColorfill, icons that were previously black might now get a different color. For example, an SVG inside adivwith blue text will now become blue instead of the default path color of black. - We dropped the
--fa--fafor Duotone which we briefly introduced for FA6. You can now trigger the second layer of a Duotone icon by ligatures (just repeat the Unicode value) or enabling a stylistic set (font-feature-settings: "ss01").