⬇️ Dropdown Header

:mag: Overview

This theme component allows you to add links and dropdowns in the header of your Discourse site.

:computer: Code

View the GitHub Repo

:gear: Settings

There are a variety of settings you can configure to customize the component, including link customizations, icon sourcing, adding link security, positioning, etc.

A list of all the settings and detailed explanations about them can be found here.

:thinking: When to Use

This component is useful if you want links and dropdown links inline with Discourse’s existing header. Its recommended to only use this if you have a few links (3/4) so there is sufficient space.

If you need more than a few dropdown links, check out Header submenus by @Johani which creates a header menu row above Discourse’s original header.

Although this component also supports adding links alone without the dropdowns, if you only need links without the dropdowns, feel free to use Custom Header Links also by @Johani:

:clapper: Preview



Due to lack of space on mobile, links can be triggered by tapping on the arrow down button.

Install Theme Component


Not sure why but this doesn’t seem to work for me, as soon as it’s enabled my header vanishes, on a clean theme with no other components, tried multiple base themes also

<div id="ember7" class="d-header-wrap ember-view"><div></div></div>



1 Like

Hey @Fma965, my apologies, I have pushed out some fixes for some small bugs, it should hopefully be working now for you. Let me know how it goes.


Works great now, Thanks!

1 thing to note is that since these don’t use a tags you can’t middle click the links like you can on the header links plugin, is there a reason you aren’t using a tags?

1 Like


Hmm… that’s an interesting point. The reason I didn’t use anchor tags is because each link is a widget that may generate a dropdown if dropdown items are present. With using the widget I am also taking advantage of the click() method that calls: DiscourseURL.routeTo(this.attrs.url);.

This has some benefits such as maintaining the history of where you are in a topic. For example if you click on a link to a topic with an anchor tag it always starts you off at the top of the topic. However, if you’ve visited the topic before and you were last reading halfway through the topic, the routeTo approach will bring you to that same position on the topic.

I wonder if there’s a way to add middle click functionality to widget clicks… will have to look into that, perhaps someone on the Discourse team might have an idea.

1 Like

Yes I figured it would be relating to this, was just something one of my moderators mentioned to me, figured I’d raise the point here just incase :slight_smile:

1 Like

Hi Keegan, thanks for creating this theme component! It is the perfect bridge between the Custom Header Links and Header Submenu components I had looked at before.

Any chance to add a ‘target’ option (open in new tab) to the links we add there, like in the other two theme components?

1 Like

I am manually populating the submenu items from an external source and I send couple of ajax requests inside a loop to retrieve them. Naturally, if there are many items. The component loads before all the requests are finished and some items are missing. Is it possible to modify the source to achieve this?

1 Like

Amazing component. Thank you for sharing :heart:.

Hello! Thanks for this fantastic component :slight_smile:

There seems to be a margin missing on the right when not connected on the forum. Here’s how it looks like :
Capture d’écran 2022-12-05 à 16.22.20

Whereas if I’m connected it’s fine.

Hope it helps improving it.

Any chance there could be:

  1. links to eternal URLs?
  2. target links to open in new tabs as previously mentioned?

We are just setting up a new instance on the Discourse servers and are trying to get our Discourse menu to match our WP site as closely as a practicable.

Thank you

I just installed this component to replace the “Custom Header Links” and also “Easy Footer components”.

And I really love this component, it is great!

Works for me. Do you mean a _blank target or something like this or external urls in general (which work for me)?

I noticed one thing: On mobile devices I cannot scroll down. It seems that I have too many menus. :wink: Can this be adjusted?

I just made a PR for that problem:

When you check the link above you can see that the adjusted CSS works as it should. :slight_smile:


Hi, thanks for this great component!
However, I have noticed that when I click on a link, all the texts and icons are replaced with those of the last element.

I also noticed that if I click on the logo, the texts and icons of the links change

I attach a short video example:

The page link is: Forum › Portale CMS - ITTS E. Scalfaro

How can I fix? Many thanks in advance!