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

**URL:** https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296
**Category:** Support
**Created:** [March 22, 2019, 12:22am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296 "2019-03-22T00:22:55Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![watchmanmonitor](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/watchmanmonitor/32/430970_2.png) [@watchmanmonitor](https://meta.discourse.org/u/watchmanmonitor)
#### Post date: [March 22, 2019, 12:22am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/1 "2019-03-22T00:22:55Z")

</div>

In the sample [“new like icon” repo,](https://github.com/discourse/new-like-icon/blob/8a02cf7595a970fbfdbd5b28b2584dbab57ba5cd/common/header.html#L1-L8) we see:

```js
<script type="text/discourse-plugin" version="0.8">
      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');
</script>

```

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?

---

<div class="post-metadata">

### Author: ![tshenry](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tshenry/32/119495_2.png) [@tshenry](https://meta.discourse.org/u/tshenry)
#### Post date: [March 22, 2019, 12:28am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/2 "2019-03-22T00:28:39Z")

</div>

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](https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse-common/addon/lib/icon-library.js)

---

<div class="post-metadata">

### Author: ![watchmanmonitor](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/watchmanmonitor/32/430970_2.png) [@watchmanmonitor](https://meta.discourse.org/u/watchmanmonitor)
#### Post date: [March 24, 2019, 1:10am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/3 "2019-03-24T01:10:50Z")

</div>

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](https://meta.discourse.org/t/how-to-replace-an-icon-using-css/78714/5)

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?

---

<div class="post-metadata">

### Author: ![tshenry](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tshenry/32/119495_2.png) [@tshenry](https://meta.discourse.org/u/tshenry)
#### Post date: [March 24, 2019, 1:44am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/4 "2019-03-24T01:44:20Z")

</div>

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

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

```

---

<div class="post-metadata">

### Author: ![watchmanmonitor](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/watchmanmonitor/32/430970_2.png) [@watchmanmonitor](https://meta.discourse.org/u/watchmanmonitor)
#### Post date: [March 26, 2019, 3:25pm UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/5 "2019-03-26T15:25:37Z")

</div>

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.

---

<div class="post-metadata">

### Author: ![oshyan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/oshyan/32/212644_2.png) [@oshyan](https://meta.discourse.org/u/oshyan)
#### Post date: [October 31, 2021, 2:35am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/6 "2021-10-31T02:35:12Z")

</div>

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](https://meta.discourse.org/t/introducing-font-awesome-5-and-svg-icons/101643)  
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.

---

<div class="post-metadata">

### Author: ![ondrej](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ondrej/32/198804_2.png) [@ondrej](https://meta.discourse.org/u/ondrej)
#### Post date: [October 31, 2021, 9:48am UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/7 "2021-10-31T09:48:40Z")

</div>

> [@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](https://fontawesome.com/v5.15/icons?d=gallery&p=2&s=regular,solid&m=free). 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](https://meta.discourse.org/t/fontawesome-pro-icons/150871) plugin.

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [October 31, 2021, 2:25pm UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/8 "2021-10-31T14:25:30Z")

</div>

[https://meta.discourse.org/styleguide/atoms/icons](https://meta.discourse.org/styleguide/atoms/icons)

You have this on your forum too. You might need to enable the plugin.

---

<div class="post-metadata">

### Author: ![oshyan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/oshyan/32/212644_2.png) [@oshyan](https://meta.discourse.org/u/oshyan)
#### Post date: [October 31, 2021, 5:17pm UTC](https://meta.discourse.org/t/where-can-i-find-a-list-of-icons-used-by-discourse/112296/9 "2021-10-31T17:17:07Z")

</div>

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. 😉