Custom Header Links (icons)

:discourse2: Summary Custom Header Links (icons) will allow you to easily add linked icons to the Discourse header.
:eyeglasses: Preview Preview on
:hammer_and_wrench: Repository Link
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component




This component includes a theme setting that allows you to add as many links as you want, determine their icons, and decide which devices they show up on!

The pattern for links is as follows:


Title is… well…the title you want the link to have.

URL is where you want the user to go when they click. Include protocol like https://
Alternatively, as @dnsmichi pointed out, you can also use relative links like /c/staff

Icon can be either:

If the icon you want to use does not show up, then add it to the svg_icons setting in the component. if you add new icons, they need to be prefixed with FontAwesome 5 prefixes like fab, far and fas.

View can have one of three values:

Desktop only

Mobile and desktop

Mobile only

Target can be:

Opens link in the same tab

Open link in a new tab

Then add the component to your theme as a theme component and you’re all set!


This is based on @techAPJ’s awesome tutorial here: Add new link on header beside search icon

and on @vinothkannans’s Brand header theme which was a great reference for the structure of this component.

How are theme setting fields created?
Mingle - An Introductions Plugin
(Superseded) Add new link on header beside search icon
Login Required activated - after successfull login it transfers you to nonexisting page
Adding centerized icons on d-header
Custom Admin Toolbox
2021: The Year in Review
How to use my own SVG icons in Custom Header Links theme component?
How to use my own SVG icons in Custom Header Links theme component?
Show "new topic" when not logged in
Help changing Help Guide Permalink
Generic URL for private messages?
Display a "Discord Widget" in a dropdown button
Customize the header with links, icons, or menus
(Superseded) Add new link on header beside search icon
How to remove iconified header links from mobile?
Header icons color on mouse hovering issue
Link on Top header to Go to Home page of main site
Custom Hamburger Menu Links
Can I add a icon and link back to my homesite at the top bar
How to add a "button" which composes a pre-filled topic
Custom Header Links
Custom Header Links
[PAID] Moving the Anonymous icon onto the header
Category for Threads with zero replies?
Install a theme or theme component
Install a theme or theme component
Plugin: add a menu icon (next to search)
Introducing Font Awesome 5 and SVG icons
Mingle - An Introductions Plugin
Introducing Font Awesome 5 and SVG icons
Introducing Font Awesome 5 and SVG icons
Adding a custom Link/Icon to the discourse header
Adding a link into the mobile header
How can I add a button to the header?
Add custom buttons at the top of the site
Problem with beta6: Header Link Theme Component no longer working
Discourse messaging guide for new users
Insert Link to External Website
Missing custom header link ico after update
My 2nd Discourse forum, 2 years after the first one
Custom Buttons with own functions
Header Submenus

I’m having a similar issue as a few people mentioned above where the icon is not showing, but I can still click the button. I made the edit to the icon setting so that it says (for instance) “fab-facebook-f” rather than just “facebook-f”. For Twitter and my other website, I have no issues, but for Facebook and LinkedIn, it’s still not working.

I figured out Facebook, but still can’t get LinkedIn. Also, is there any way to make a custom icon? Could I upload my company’s logo and use it as an icon?

Me too – with Discord icon.

How come I don’t have ‘svg icons’ section in latest version?

I have this:

That settings screenshot looks like the Custom Header Links - #84 by TheBaby5 component, which is for showing text links not icons.

I can see how the components are named in a confusing way:

  • - icon links (this topic)
  • - text links (Custom Header Links)

Maybe you should add icon to this one’s name @Johani?


Ah this resolved it, indeed. Yep - super confusing. Rename would rock!

EDIT: Recent update also seemed to ninja change discord’s class name to include fab- in between it (eg, if you’re wanting to change the icons color; which @OP would make a great native feat - was a bit hard to catch).

1 Like

For Linkedin you can use fab-linkedin as the icon name in this setting

setting for links

but since that icon is not included in the default set of icons that Discourse uses, you will also need to add it to the other setting in the component.

The result looks like this for me

linkedin icon

Sure, there’s a section in this topic about adding custom icons.

Once you have that setup, you’ll be able to use any custom icons you add in this theme component. Please have a look there and let me know if you run into any issues.

I’ve made that change along with a couple of other implementation improvements here

The new update adds unique prefixed classes to each link based on the title you use. So, for example if you use

facebook, fab-facebook,, vdm, blank

the link will have the class


The template is header-icon-ICON-TITLE

Which you can then target with CSS like so

.d-header-icons {
  .header-icon-facebook svg {
    fill: #4267b2;

  .header-icon-twitter svg {
    fill: #1da1f2;

  // add more icons here

which would result in something like this

colored icons


Thank you for your help. I tried using “fab-linkedin” in both the “Header Links” and “Svg Icons” categories. As seen in the picture, it is still not working for whatever reason.

Screen Shot 2020-08-05 at 9.48.15 AM

The grey circle is where the LinkedIn logo would be. Any other ideas how to fix it?

I’m not entirely sure why that’s not working for. Here are what my settings look like

Facebook, fab-facebook,, vdm, blank
Twitter, fab-twitter,, vdm, blank
LinkedIn, fab-linkedin,, vdm, blank



and here’s what I’m seeing


Can you please try the same for the linkedin icon and let me know if your issue presists?

1 Like

This is what I have been trying, and I have tried different icons as well. Here is how I have it currently.



The only ones working are the ones that don’t use “fab-”, which seems weird. Let me know your thoughts.

Hi Michelle,

Since you are a customer, I went in and had a look at your site and fixed the issue there for you. I updated the theme component and set the correct settings for the icons, they should all work now.


It looks great now, thank you!


One more question/ request; I initially had these links opening in a separate tab, but now they are opening in the same tab. The setting is already set to “blank”, how else can I change this?


This looks like a regression, we’ll look into it and have a fix soon.

1 Like

Indeed. I accidentally left out the target attribute in the recent changes.

No action needed on your side. I fixed the component and updated it on your site. So everything should be all set now. Thanks for reporting the issue :+1:



Custom icons are on the right of the login and sign up button, and I think they would fit better on the left, as they usually are.




I can get some version 4.7.0 icons from Font Awesome Icons to work just by typing a name (e.g. car) in the correct part of “Header links”. Some icons don’t show (e.g. fa-comments-o). Some don’t need me to use “Svg icons” (e.g. home) and some do (e.g. car).

None of the version 5 icons which I’ve tried from Font Awesome have worked. I’ve put the fa- name into “Header links” and “Svg icons” to no effect. The fab-facebook (etc) icons which were there by default do work though.

What am I doing wrong?

Edit: I edited the first paragraph for accuracy.

many thanks for this @Johani . works like a charm and gives me an “aesthetical” solution for linking “back to the site” (in my case)

i did however, encounter an issue since i am also using the Left side hamburger menu on mobile component which ends up breaking everything on that part of the .d-header

any ideas on how can i make both work? would really appreciate it

I am also having an issue getting my icon to show up. Not sure what I am doing wrong. Here is what I have under settings:

This is what I end up with:


for the book icon, try without fas-