Jump to content
Forum²

Recommended Posts

  • Forum² Admin
Posted

What’s Font Awesome?

Discourse uses a free set of icons from Font Awesome throughout its interface. You see these on toolbars, badges, buttons, etc… here’s our composer toolbar:

Since 2018 we’ve been using Font Awesome 5 (original announcement), and in the meantime Font Awesome 6 has been released. Version 6 includes new icons, some general style updates, and renames.

As of today, Discourse will start using version 6 too! Specifically, version 6.6.0. This isn’t an enormous visual change, but you’ll notice some differences:

What does this upgrade involve?

This upgrade was a little more complicated to implement because it involves a number of renames. Font Awesome did this to make their naming conventions more consistent.

Because of the renames, changes will be rolled out in multiple phases:


Today - Font Awesome upgraded to v6, icons will be automatically remapped
Soon - deprecation messages will be enabled to help theme/plugin authors update their icon names
Q4 2024 - admin warning banner enabled for any remaining deprecations
Q2 2025 - removal of automatic remapping


What do I need to do today?

Nothing at all :tada:! Once Discourse is updated, you’ll have the new version of the icons.

Discourse will automatically remap old icon names to new icon names, and the old icons will all be replaced. This includes icons used in the interface by default as well as badges, group/user flair, sidebar items, and additional icons added by themes and plugins.

What do theme and plugin authors need to know?

The methods covered in Introducing Font Awesome 5 and SVG icons will still work for adding new and custom icons.

We don’t want to carry the long list of remaps forever, so the old names will eventually stop working.

We want to give developers ample time to replace old icon names, so we will start showing console warnings like this soon:

If you see one of these warnings, all you need to do is update your theme or plugin with the new icon name. Later in 2024 we’ll show admins a banner drawing their attention to these warnings.

Once the admin deprecation warning is shown, you’ll have a minimum of a few months to swap in the new icon names.

At some point in Q2 2025 we will remove the remapping of the old names, and if you haven’t updated icon names by then, you’ll see blank spaces where some of your icons used to be.

There are lots of new icons!

The upgrade from version 5 to 6 introduces hundreds of new free-to-use icons, almost 500 in total!

You can browse the full set here, this is sorted to show the newest additions first — and the search is very handy: Search Icons & Find the Perfect Design | Font Awesome

21 posts - 9 participants

Read full topic

Guest
This topic is now closed to further replies.
×
×
  • Create New...