# Custom Hamburger Menu Links

**URL:** https://meta.discourse.org/t/custom-hamburger-menu-links/87644
**Category:** Theme component
**Tags:** deprecated
**Created:** [May 16, 2018, 2:15pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644 "2018-05-16T14:15:15Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![Johani](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/johani/32/176920_2.png) [@Johani](https://meta.discourse.org/u/Johani)
#### Post date: [May 16, 2018, 2:15pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/1 "2018-05-16T14:15:15Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Custom Hamburger Menu Links** will allow you to easily add links to the hamburger menu. |
| 👓 | **Preview** | [Preview on theme-creator.discourse.org](https://theme-creator.discourse.org/theme/awesomerobot/hamburger-links) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-custom-hamburger-links](https://github.com/discourse/discourse-custom-hamburger-links) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |

Install this theme component

### Samples

Desktop

 ![Capture](https://global.discourse-cdn.com/meta/original/3X/2/0/20159d53401de353da0b733c3b6fe7f13d469efd.PNG)

Mobile

 ![Capture2](https://global.discourse-cdn.com/meta/original/3X/d/6/d60a2d36b925346050df81df2aaa555110bced2d.PNG)

* * *

### Settings

You add links via comma delimited values in this order:

`Text,URL,Location,Target`

**Text**  
is the name of the link that shows on the menu.

**URL**  
is the path you want the link to have. You can use relative paths like

`/tags/funny`  
or  
`/t/231`

if you prefer.

**Location**  
can have one of two values. Either the letter `g` or the letter `f`

Use “g” if you want the link to appear in the `generalLinks` section:

 ![Capture3](https://global.discourse-cdn.com/meta/original/3X/a/f/afdb73d7814bbd3318c175ff5473aa89faf0a38c.PNG)

or use “f” if you want the link to appear in the `footerLinks` section:

 ![Capture4](https://global.discourse-cdn.com/meta/original/3X/1/e/1e3152377ead89d55213d8467f19adc676b0fe3d.PNG)

**Target (optional)**  
Use “blank” if you need the link to open in a new tab.

---

<div class="post-metadata">

### Author: ![NemesisRE](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nemesisre/32/96665_2.png) [@NemesisRE](https://meta.discourse.org/u/NemesisRE)
#### Post date: [May 16, 2018, 3:31pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/2 "2018-05-16T15:31:16Z")

</div>

Thats a nice addition, thanks for that. It’s already installed 😃

Could you add a target option so that it is possible to open the link in a new tab/window (if no target is given just use “`_self`”)

`Text,URL,Location,Target`

---

<div class="post-metadata">

### Author: ![ngets](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ngets/32/185583_2.png) [@ngets](https://meta.discourse.org/u/ngets)
#### Post date: [July 8, 2020, 2:41am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/46 "2020-07-08T02:41:19Z")

</div>

Please add an option to place the link at the very top of the dropdown panel 🙂

---

<div class="post-metadata">

### Author: ![nathank](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nathank/32/290039_2.png) [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [August 28, 2020, 10:13pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/47 "2020-08-28T22:13:07Z")

</div>

I might have a go at this myself at some stage (have to learn a wee bit first), but I’m putting my thoughts down here for now:

### Feature Requests:

No 1: Allow hover text. This is now used for the core hamburger links, and would be very helpful

No 2: Merge with Rob’s fork, which is clearly a good idea:

> [@merefield](#):
>
> Just add an additional `,N` if you want the link to appear for anon users (aka Not Private), or `,Y` if you don’t (Yes to Private).

No 3: Allow target=“\_blank” as per Richie (also clearly a great idea):

> [@Richie](#):
>
> This is a great component but I’d also love to be able to target links to a new window 😃

No 4: Allow more control of link ordering (likely very tricky!)

---

<div class="post-metadata">

### Author: ![mentalstring](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mentalstring/32/168934_2.png) [@mentalstring](https://meta.discourse.org/u/mentalstring)
#### Post date: [October 7, 2020, 12:30pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/48 "2020-10-07T12:30:34Z")

</div>

Is there a way that the custom hamburger menu links can be translated depending on the user interface language?

For example, I could wrap yaml translation files into a custom plugin, but I’m not sure which translation keys I could use.

No practical way to do this?

---

<div class="post-metadata">

### Author: ![rolando](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rolando/32/193660_2.png) [@rolando](https://meta.discourse.org/u/rolando)
#### Post date: [October 10, 2020, 12:20pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/49 "2020-10-10T12:20:38Z")

</div>

is there any way on customizing the links in order to place them on a certain order?

---

<div class="post-metadata">

### Author: ![savas](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/savas/32/131277_2.png) [@savas](https://meta.discourse.org/u/savas)
#### Post date: [November 4, 2020, 11:45am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/50 "2020-11-04T11:45:46Z")

</div>

So are we got the possibility to open in new tab?

---

<div class="post-metadata">

### Author: ![Richie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/richie/32/115110_2.png) [@Richie](https://meta.discourse.org/u/Richie)
#### Post date: [November 5, 2020, 7:20pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/51 "2020-11-05T19:20:13Z")

</div>

I don’t think anyone is working on this anymore @savas 😕

---

<div class="post-metadata">

### Author: ![mognet](https://avatars.discourse-cdn.com/v4/letter/m/f6c823/32.png) [@mognet](https://meta.discourse.org/u/mognet)
#### Post date: [November 6, 2020, 8:16pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/52 "2020-11-06T20:16:54Z")

</div>

Seems i have trouble adding this to footer links even i add f on Locations. Does anyone have the same trouble?

---

<div class="post-metadata">

### Author: ![Richie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/richie/32/115110_2.png) [@Richie](https://meta.discourse.org/u/Richie)
#### Post date: [March 6, 2021, 9:18pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/53 "2021-03-06T21:18:45Z")

</div>

I got really excited this evening when I saw this!!

 ![Screen Shot 2021-03-06 at 21.16.08](https://global.discourse-cdn.com/meta/original/3X/7/a/7a9f6636519824eec7aaa668f0b53f6ee3155749.png)

I was soooooo much hoping that there was a new feature to open links to a `target="_blank"`😱

Jumped straight on GitHub to see what was new!

 ![Screen Shot 2021-03-06 at 21.18.00](https://global.discourse-cdn.com/meta/original/3X/2/1/21c7a75d42cd960964fa21f9d65805d6be16c9ad.png)

Oh @tshenry I was so disappointed 😔

🤣

---

<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 9, 2021, 1:07am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/54 "2021-03-09T01:07:05Z")

</div>

> [@Richie](#):
>
> I was so disappointed 😔

Maybe this will help? 😉

[https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1f](https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1f)

That seemed to be the most requested feature and it wasn’t too hard to add support. That’s it for now though 🙂

---

<div class="post-metadata">

### Author: ![Richie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/richie/32/115110_2.png) [@Richie](https://meta.discourse.org/u/Richie)
#### Post date: [March 9, 2021, 5:01pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/55 "2021-03-09T17:01:19Z")

</div>

My life is now complete 😍

Thank you @tshenry this is fantastic news 👏🏻 🙇🏻‍♂️

---

<div class="post-metadata">

### Author: ![Krunnie](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/krunnie/32/216504_2.png) [@Krunnie](https://meta.discourse.org/u/Krunnie)
#### Post date: [April 20, 2021, 5:38pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/56 "2021-04-20T17:38:04Z")

</div>

Hey quick question, how does one localize the custom hamburger menu text? I want to fully localize my forum and I can’t seem to find the text anywhere.

---

<div class="post-metadata">

### Author: ![thegurjyot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thegurjyot/32/120516_2.png) [@thegurjyot](https://meta.discourse.org/u/thegurjyot)
#### Post date: [May 24, 2021, 8:35pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/57 "2021-05-24T20:35:49Z")

</div>

This is a useful component. But can we add font awesome icons there? It would be great to show social media profile icons there, so that people can follow our social profiles easily.

---

<div class="post-metadata">

### Author: ![gomezcarsonk](https://avatars.discourse-cdn.com/v4/letter/g/5daacb/32.png) [@gomezcarsonk](https://meta.discourse.org/u/gomezcarsonk)
#### Post date: [May 25, 2021, 1:35pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/58 "2021-05-25T13:35:56Z")

</div>

> [@tshenry](#):
>
> Maybe this will help? 😉
> 
> [https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1f](https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1f)[employee time tracking](https://www.worktime.com/employee-time-tracking-software)
> 
> That seemed to be the most requested feature and it wasn’t too hard to add support. That’s it for now though 🙂

That is fantastic, thank you! 😉  
Maybe you can tell me quickly - how to localize the custom hamburger menu text?

---

<div class="post-metadata">

### Author: ![manuel](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/manuel/32/468169_2.png) [@manuel](https://meta.discourse.org/u/manuel)
#### Post date: [July 1, 2021, 10:11am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/59 "2021-07-01T10:11:34Z")

</div>

I added support for icons, you could try out this fork of the component: [https://github.com/nolosb/discourse-custom-hamburger-links-with-icons.git](https://github.com/nolosb/discourse-custom-hamburger-links-with-icons.git)

Two notes on usage:

- The icon would be the first item in the list:  
 ![Screenshot from 2021-07-01 11-10-15](https://global.discourse-cdn.com/meta/original/3X/0/d/0dd8128fb42ed59dcb37c1c70f5c803541793aaf.png)  
If you want a link without icon, just don’t add it, but keep the trailing comma `,`  
 ![Screenshot from 2021-07-01 11-10-40](https://global.discourse-cdn.com/meta/original/3X/b/7/b71755155b333596930cde8ef4b8072d9fe34ce0.png)

- If the icon is not included by default, remember to add it to the icon list:  
 ![Screenshot from 2021-07-01 11-11-06](https://global.discourse-cdn.com/meta/original/3X/4/f/4f9586939de84ae71af882a04a4c768bf0616aea.png)

---

<div class="post-metadata">

### Author: ![thegurjyot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thegurjyot/32/120516_2.png) [@thegurjyot](https://meta.discourse.org/u/thegurjyot)
#### Post date: [July 3, 2021, 6:51am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/60 "2021-07-03T06:51:48Z")

</div>

Can you puch these changes to the official Theme component? It’s always better to have the official Theme component installed as it’s going to be maintained with Discourse future updates.

---

<div class="post-metadata">

### Author: ![AquaL1te](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/aqual1te/32/201966_2.png) [@AquaL1te](https://meta.discourse.org/u/AquaL1te)
#### Post date: [July 4, 2022, 6:53am UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/62 "2022-07-04T06:53:18Z")

</div>

It would be nice to have this merged with the official plugin. I want to add social media buttons in the hamburger menu. But without icons it would not look as nice.

Also, it’s a bit unclear that no space is allowed in the CSV fields.  
This works: `Footer Link,https://google.com,f`  
But with spaces the item gets inserted in the general field rather than the footer, because of the missing space: `Footer Link, https://google.com, f`

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [October 15, 2022, 11:16pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/63 "2022-10-15T23:16:41Z")

</div>

Hi!

With the new sidebar, being able to add custom icons to our links would be a nice addition.

 ![image](https://global.discourse-cdn.com/meta/original/4X/e/0/c/e0c4b596e8b85c48fc2ad385bfda56afa9609f41.png)

I can try to work on this and do a PR in the following days…

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [October 17, 2022, 10:52pm UTC](https://meta.discourse.org/t/custom-hamburger-menu-links/87644/64 "2022-10-17T22:52:59Z")

</div>

Quick question…

I’ve installed the theme component on a new Discourse instance, but for some unidentified reason, the default links won’t appear in the **more** section of the sidebar:

 ![image](https://global.discourse-cdn.com/meta/original/4X/4/6/9/469d7a6bcc3de5232886c44134d86d74a8db4671.png)

I didn’t modify the code, it’s a fresh theme component install.

However, the theme component, installed two years ago, works on my other forum:

 ![image](https://global.discourse-cdn.com/meta/original/4X/3/4/6/346c4c94351d1edd26aed5cc6f1cae631fd540f0.png)

No error is displayed. Any idea why the theme component doesn’t work on my new install? 🤔

[Next page](https://meta.discourse.org/t/custom-hamburger-menu-links/87644.md?page=2)
