In the sample “new like icon” repo, we see: api.replaceIcon('d-liked', 'thumbs-up'); api.replaceIcon('d-unliked', 'thumbs-o-up'); api.replaceIcon('notification.liked', 'thumbs-o-up'); api.replaceIcon('notification.liked_2', 'thumbs-o-up'); api.replaceIcon('notification.liked_many', 'thumbs-o-up'); api.replaceIcon('heart', 'thumbs-up'); I don’t know that I’d have guessed to replace notification.liked_many_2 Where could we see a list of all the icons in use by discourse?

This should be what you are looking for: https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse-common/addon/lib/icon-library.js

I was trying to replace an icon over in this topic: https://meta.discourse.org/t/how-to-replace-an-icon-using-css/78714/5?u=watchmanmonitor The icon in question was .d-icon-lock, but I don’t see it in the list above. Where would I find the icon, so I know what to target in the api.replaceIcon above?

In this case you would just use the FA icon name: api.replaceIcon('lock', 'times-circle');

I see. I guess I was asking for a list of all icons.. perhaps searching the source for {d-icon ' is what I’m looking for.

I have the same question, and the link above doesn’t work. I searched and skimmed through a lot of this topic: Introducing Font Awesome 5 and SVG icons But likewise I don’t see a list to know whether an icon is in the core set or not. Can’t find any other related search results on the forum either.

[image] oshyan: I don’t see a list to know whether an icon is in the core set or not Discourse uses the free font awesome icons. All available icons that can be used are found here. You may have to add some icons to the svg icon subset in the site settings. You can see what icons are on your site by adding /styleguide/atoms/icons to the URL. If this does not appear please check styleguide enabled in site settings. If you want to access the pro icons you need to install the Discourse FontAwesome Pro plugin.

https://meta.discourse.org/styleguide/atoms/icons You have this on your forum too. You might need to enable the plugin.

Thanks @ondrej and @pfaffman ! I was familiar with the use of Font Awesome, and I knew I may need to add some new ones, which is why I wanted to know what was included. The Meta and Styleguide plugin links are both very helpful. Still having a bit of trouble figuring out how to add new ones in some (but oddly not all) cases, but I’ll make a separate topic/reply about that. :wink:

Where can I find a list of icons used by Discourse?

Product Support

tshenry (Taylor) March 24, 2019, 1:44am 4

In this case you would just use the FA icon name:

<script type="text/discourse-plugin" version="0.8">
  api.replaceIcon('lock', 'times-circle');
</script>

Topic		Replies	Views
Alternative icons Developer Guides reference , theme-guides	28	3511	April 7, 2026
Harmonizing Discourse icons and emojis UX planned	11	2333	November 30, 2021
I can't change the notification icons Development	6	952	January 30, 2023
Change icons globally Developer Guides how-to	26	10796	October 5, 2025
Change icon style in discourse Product Support	1	312	March 4, 2025

Where can I find a list of icons used by Discourse?

Related topics