Continuing the discussion from How do I add links to site settings into the settings description of my component? : I wonder if something similar is possible for a link to the free FontAwesome icons. That one is used in the settings description of some components, and if those only contained %{FA_fr…

I think ideally we would link to https://meta.discourse.org/styleguide/atoms/icons , and it would have a nice search interface to access all available icons. I did have a WIP for that a few months ago… will have to dust it off and see if I can get it mergeable :eyes:

[image] david: I think ideally we would link to https://meta.discourse.org/styleguide/atoms/icons , Doesn’t that only show icons already added to the forum? I think it’s quite common to choose other free icons in components like “Social share”.

[image] Moin: Doesn’t that only show icons already added to the forum? At the moment yes, but we could improve it to show all available icons. (with an indicator on the ones which are already added)

I thought it might make sense to bump this topic because of DEV: upgrade to fontawesome 7 by tyb-talks · Pull Request #36286 · discourse/discourse · GitHub being merged. Lots of descriptions of settings of theme components and plugins will need an update again now. So, while for most components it’…

How do admins know which FontAwesome icons they can use? I mean, currently, it’s safe to assume using the most current version. But when V8 is published, there will be a time where you need to know that icons added in FA8 won’t work, and in cases where the name was changed, you also need to use the …

[image] Moin: also need to use the FA7 name of the icon. Or is that no longer a problem? FA6 had a lot of renames, which is why it was so painful. I don’t think FA7 had any - just new/improved icons. [image] Moin: How do admins know which FontAwesome icons they can use? I think in an …

[image] david: I think in an ideal world, theme/site settings would be able to make use of our icon dropdown. I was hoping adding placeholders for the version number and a link to the FA website that can be used in component setting descriptions might be easier than a site setting & theme set…

[image] david: I think in an ideal world, theme/site settings would be able to make use of our icon dropdown. [SCR-20260114-txbb] Site settings do that now, but the description of the setting still links to the list of FA6 icons (not 7, and the filter to only return free icons doesn’t work …

Using a placeholder for FontAwesome links in descriptions of settings

Development

david (David Taylor) January 14, 2026, 10:55pm 6

Would it be better to just remove the version number from these strings?

Topic		Replies	Views
Custom Header Links (icons) Theme component official , custom-header-icons	119	31654	August 4, 2025
Introducing Font Awesome 5 and SVG icons Announcements new-feature	135	42691	December 1, 2023
We're upgrading our icons to Font Awesome 6! Announcements	39	3847	March 27, 2025
Adding icons for the Welcome Link Banner Support welcome-link-banner	4	478	February 22, 2022
Alternative icons Developer Guides theme-guides , reference	28	2402	April 7, 2026

Using a placeholder for FontAwesome links in descriptions of settings

Related topics