# Change icons globally
**URL:** https://meta.discourse.org/t/change-icons-globally/87751
**Category:** Developer Guides
**Tags:** how-to
**Created:** [May 17, 2018, 3:45pm UTC](https://meta.discourse.org/t/change-icons-globally/87751 "2018-05-17T15:45:00Z")
**Posts on this page:** 7
**Page:** 2
### Author:  [@tomtjes](https://meta.discourse.org/u/tomtjes)
#### Post date: [July 30, 2020, 1:06pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/22 "2020-07-30T13:06:38Z")
Yes, follow this guide: [Replace Discourse's default SVG icons with custom icons in a theme](https://meta.discourse.org/t/replace-discourses-default-svg-icons-with-custom-icons-in-a-theme/115736)
---
### Author:  [@cogdog](https://meta.discourse.org/u/cogdog)
#### Post date: [September 17, 2020, 5:17pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/23 "2020-09-17T17:17:20Z")
Bump, please. I have the same question.
Out of the box, discourse uses the link icon at the bottom of post as a “share” button (it’s more than the link, it offers social media sharing) yet the same icon is used in the editor to edit a link.
These really ought to be different; they are different functions. OR if anyone has a way to override the global change in the post editor, I’d appreciate it.
---
### Author:  [@timjbanks](https://meta.discourse.org/u/timjbanks)
#### Post date: [July 1, 2021, 4:12pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/24 "2021-07-01T16:12:30Z")
Recently changed the Like icon from the “heart” to " book-reader".
Had great success changing all of the Like icons, except the one in the notifications, drop-down list
I’ve used the following header, adding all possible options I could think of:
```plaintext
```
The heart has been replaced everywhere on the platform, except for the notification drop-down list…
Any thoughts?
---
### Author:  [@dax](https://meta.discourse.org/u/dax)
#### Post date: [July 1, 2021, 5:00pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/25 "2021-07-01T17:00:49Z")
Try to add also
`api.replaceIcon('notification.liked_consolidated', 'book-reader');`
>
---
### Author:  [@timjbanks](https://meta.discourse.org/u/timjbanks)
#### Post date: [July 1, 2021, 5:20pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/26 "2021-07-01T17:20:42Z")
Thanks for the response, Daniela!
Added it, but still no change. The heart still shows as the notification icon.
```plaintext
```
Other than this instance, the book-reader icon has replaced all heart icons everywhere.
Thought it might be an icon conflict, so I changed from “book-reader” to “pencil”, since I know notifications can use that icon. Didn’t work, still a heart.
Any thoughts?
---
### Author:  [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [October 5, 2025, 11:56am UTC](https://meta.discourse.org/t/change-icons-globally/87751/27 "2025-10-05T11:56:09Z")
I tried to replace the `envelope` icon with the `inbox` icon, but the changes are not applied to the icons inside the user menu panel. Do they have to be targeted in a specific way?
My snippet:
```js
// {theme}/javascripts/discourse/api-initializers/init-theme.gjs
import { apiInitializer } from "discourse/lib/api";
export default apiInitializer((api) => {
api.replaceIcon("envelope", "inbox");
});
```
---
### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [October 5, 2025, 1:10pm UTC](https://meta.discourse.org/t/change-icons-globally/87751/28 "2025-10-05T13:10:20Z")
Hello @jrgong 👋
Here you can find the icon replacements what contains the notifications.
>
Add this line to your snippet:
```js
api.replaceIcon("notification.private_message", "inbox");
```
[Previous page](https://meta.discourse.org/t/change-icons-globally/87751.md?page=1)