# Brand Header

**URL:** https://meta.discourse.org/t/brand-header/77977
**Category:** Theme component
**Tags:** official, brand-header
**Created:** [January 14, 2018, 6:27am UTC](https://meta.discourse.org/t/brand-header/77977 "2018-01-14T06:27:03Z")
**Posts on this page:** 1
**Showing post:** 266

<div class="post-metadata">

### Author: ![pacharanero](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pacharanero/32/500583_2.png) [@pacharanero](https://meta.discourse.org/u/pacharanero)
#### Post date: [October 1, 2025, 3:24pm UTC](https://meta.discourse.org/t/brand-header/77977/266 "2025-10-01T15:24:01Z")

</div>

> [@Discourse](#):
>
> To allow the Font Awesome 6 Icons to correctly display in this theme component, you will need to add them to 3 places in Discourse:
> 
> 1. The `svg icon subset` Site Setting
> 2. The `custom font awesome icons` setting in the component
> 3. The `icons` setting in the component

For a few months I’ve had a few broken icons in the Brand Header, probably since FA6 renaming. I have finally gotten around to fixing them now and just thought it might help others to comment on how the naming must be handled so that it works.

I do think it can be a bit confusing to have to look up a [mapping in the source code](https://github.com/discourse/discourse/blob/fbc2cfb6185c00950da8e915b1a32546e7020913/lib/deprecated_icon_handler.rb#L5-L682), check FA’s website, and tinker with `fa-`, `fas-` prefixes (and _no_ prefixes) to see how to make it work. Triple annoying and there is no error in the console if an icon is not found so it’s totally blind trialling.

I did get it working and here is a table explaining what is where:

| `Icons` Object setting in the component | `custom font awesome icons` setting in the component | `svg icon subset` Site Setting |
| --- | --- | --- |
| `user` | `fa-user` | `fa-user` |
| `envelope` | `fa-envelope` | `fa-envelope` |
| `calendar-days` | `fa-calendar-days` | `fa-calendar-days` |
| `fab-facebook` | (not needed) | (not needed) |

It just feels there should be one way of referring to a FA icon throughout Discourse and everything should stick to that one way.

---

_[View the full topic](https://meta.discourse.org/t/brand-header/77977)._