# \#brand-header

**URL:** https://meta.discourse.org/tag/brand-header/556.md

[Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md)

---

## [Brand Header](https://meta.discourse.org/t/brand-header/77977)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 25\
**Last updated:** [December 17, 2025, 5:31pm UTC](https://meta.discourse.org/t/brand-header/77977 "2025-12-17T17:31:13Z")

</div>

:discourse2: Summary Brand Header adds an extra top header for branding with your logo, navigation links, and social icons for both mobile and desktop views. Brand logo can be an image or text. :eyeglasses: …

---

## [Plugin Conflict Between Brand Header and Versatile Banner](https://meta.discourse.org/t/plugin-conflict-between-brand-header-and-versatile-banner/385344)

<div class="topic-metadata">

**Author:** [@philh](https://meta.discourse.org/u/philh)\
**Replies:** 6\
**Last updated:** [November 28, 2025, 9:09pm UTC](https://meta.discourse.org/t/plugin-conflict-between-brand-header-and-versatile-banner/385344 "2025-11-28T21:09:00Z")

</div>

Versatile Banner and Brand Header are not playing well together. I brought this up in Versatile Banner - #367 by philh Setting Brand Header to display above-site-header then enabling Versatile Banner the Brand header m…

---

## [Overly restrictive compatibility value for brand header component](https://meta.discourse.org/t/overly-restrictive-compatibility-value-for-brand-header-component/379434)

<div class="topic-metadata">

**Author:** [@simonk](https://meta.discourse.org/u/simonk)\
**Replies:** 2\
**Last updated:** [August 20, 2025, 8:54am UTC](https://meta.discourse.org/t/overly-restrictive-compatibility-value-for-brand-header-component/379434 "2025-08-20T08:54:08Z")

</div>

I’ve just upgraded to 3.5.0.beta9 (3cac943266) and am receiving an admin notice: \[Admin Notice\] Theme ‘Brand Header Theme Component’ contains code which needs updating. (id:discourse.widgets-end-of-life) (learn more) …

---

## [Brand Header breaks chat reply box on mobile (iOS)](https://meta.discourse.org/t/brand-header-breaks-chat-reply-box-on-mobile-ios/329466)

<div class="topic-metadata">

**Author:** [@ludwikc](https://meta.discourse.org/u/ludwikc)\
**Replies:** 10\
**Last updated:** [October 25, 2024, 1:22am UTC](https://meta.discourse.org/t/brand-header-breaks-chat-reply-box-on-mobile-ios/329466 "2024-10-25T01:22:29Z")

</div>

On iOS chat doesn’t show the reply box, making chat useless. Here’s the video documenting the bug: https://link.siadlak.com/oYK6 I’m on iPhone 12 Pro Max. I’ve tried both Discourse Hub app and PWA. Edit: changed the …

---

## [Removing brand-header by css in full size chat, but not getting full-screen chat](https://meta.discourse.org/t/removing-brand-header-by-css-in-full-size-chat-but-not-getting-full-screen-chat/331941)

<div class="topic-metadata">

**Author:** [@janbolmeson](https://meta.discourse.org/u/janbolmeson)\
**Replies:** 0\
**Last updated:** [October 21, 2024, 5:23pm UTC](https://meta.discourse.org/t/removing-brand-header-by-css-in-full-size-chat-but-not-getting-full-screen-chat/331941 "2024-10-21T17:23:01Z")

</div>

My goal I am trying to achieve is to hide brand header when users are in full-size chat. I manage to remove it by the following CSS: body.has-full-page-chat { header.b-header{ display:none; } .ember…

---

## [Brand header mobile menu doesn't fully expand until window resize](https://meta.discourse.org/t/brand-header-mobile-menu-doesnt-fully-expand-until-window-resize/312422)

<div class="topic-metadata">

**Author:** [@37Rb](https://meta.discourse.org/u/37Rb)\
**Replies:** 11\
**Last updated:** [August 2, 2024, 8:42pm UTC](https://meta.discourse.org/t/brand-header-mobile-menu-doesnt-fully-expand-until-window-resize/312422 "2024-08-02T20:42:12Z")

</div>

We’re having a problem where the brand header menu on the upper left only partially expands on mobile when tapped. We have it set to not display the bar on mobile. If I just tap the hamburger menu it looks like this. …

---

## ["An empty string is not a valid JSON string" when updating theme component](https://meta.discourse.org/t/an-empty-string-is-not-a-valid-json-string-when-updating-theme-component/319476)

<div class="topic-metadata">

**Author:** [@RGJ](https://meta.discourse.org/u/RGJ)\
**Replies:** 2\
**Last updated:** [August 1, 2024, 6:00am UTC](https://meta.discourse.org/t/an-empty-string-is-not-a-valid-json-string-when-updating-theme-component/319476 "2024-08-01T06:00:36Z")

</div>

When updating a theme component the following error occurs. Failed to update Brand Header Theme Component An empty string is not a valid JSON string. /var/www/discourse/lib/theme\_settings\_manager/objects.rb:13:in \`parse…

---

## [Brand Header links and icons settings now Object setting type](https://meta.discourse.org/t/brand-header-links-and-icons-settings-now-object-setting-type/312732)

<div class="topic-metadata">

**Author:** [@tgxworld](https://meta.discourse.org/u/tgxworld)\
**Replies:** 4\
**Last updated:** [April 26, 2024, 8:38am UTC](https://meta.discourse.org/t/brand-header-links-and-icons-settings-now-object-setting-type/312732 "2024-04-26T08:38:01Z")

</div>

Just dropping a note here that I merged in a change today which migrates the icons and links theme settings to type: objects which we recently just released. https://github.com/discourse/discourse-brand-header/commit/7e…

---

## [Align Brand Header nav links to the right?](https://meta.discourse.org/t/align-brand-header-nav-links-to-the-right/312731)

<div class="topic-metadata">

**Author:** [@cogdog](https://meta.discourse.org/u/cogdog)\
**Replies:** 2\
**Last updated:** [November 24, 2023, 2:06pm UTC](https://meta.discourse.org/t/align-brand-header-nav-links-to-the-right/312731 "2023-11-24T14:06:34Z")

</div>

I’m missing something easy. I had our brand header designed to match our other sites, where the navigation links are aligned right. Somehow in an update they are now aligned left. I’ve tried every bit of CSS but cant see…

---

## [How to move a specific link item to the right of the header?](https://meta.discourse.org/t/how-to-move-a-specific-link-item-to-the-right-of-the-header/276422)

<div class="topic-metadata">

**Author:** [@pacharanero](https://meta.discourse.org/u/pacharanero)\
**Replies:** 2\
**Last updated:** [August 24, 2023, 9:33am UTC](https://meta.discourse.org/t/how-to-move-a-specific-link-item-to-the-right-of-the-header/276422 "2023-08-24T09:33:54Z")

</div>

Great TC, one quick question about moving the .links section to the right with CSS. I’ve been attempting to move a single link from .nav .nav-pills over to the right but have not been able to achieve this. I can move the…

---

## [Brand Header layout messed up after Discourse update](https://meta.discourse.org/t/brand-header-layout-messed-up-after-discourse-update/276440)

<div class="topic-metadata">

**Author:** [@AquaL1te](https://meta.discourse.org/u/AquaL1te)\
**Replies:** 1\
**Last updated:** [August 7, 2023, 8:47pm UTC](https://meta.discourse.org/t/brand-header-layout-messed-up-after-discourse-update/276440 "2023-08-07T20:47:22Z")

</div>

Just installed the latest update and now it looks like this. I suppose that’s not intended?

---

## [How I can add a custom header](https://meta.discourse.org/t/how-i-can-add-a-custom-header/264817)

<div class="topic-metadata">

**Author:** [@Immiland](https://meta.discourse.org/u/Immiland)\
**Replies:** 5\
**Last updated:** [May 12, 2023, 4:01pm UTC](https://meta.discourse.org/t/how-i-can-add-a-custom-header/264817 "2023-05-12T16:01:26Z")

</div>

I tried to add a image to my header because had multiple color, also I tried to add by CSS but doesn’t not work, my brand colours are: background-color: #007080; background-image: linear-gradient(to right, #3b00b1, #00…

---

## [How do I change both the hover text and background color of the header menu?](https://meta.discourse.org/t/how-do-i-change-both-the-hover-text-and-background-color-of-the-header-menu/276460)

<div class="topic-metadata">

**Author:** [@rickwatson](https://meta.discourse.org/u/rickwatson)\
**Replies:** 1\
**Last updated:** [October 25, 2022, 4:40pm UTC](https://meta.discourse.org/t/how-do-i-change-both-the-hover-text-and-background-color-of-the-header-menu/276460 "2022-10-25T16:40:53Z")

</div>

How do I change both the hover text and background color of the header menu? I am not skilled with CSS? The code and where to drop it would be helpful, thanks! @vinothkannans

---

## [Logo-related features](https://meta.discourse.org/t/logo-related-features/276471)

<div class="topic-metadata">

**Author:** [@carbonrich](https://meta.discourse.org/u/carbonrich)\
**Replies:** 0\
**Last updated:** [October 7, 2022, 6:00pm UTC](https://meta.discourse.org/t/logo-related-features/276471 "2022-10-07T18:00:45Z")

</div>

Could we get a “logo dark” option? And maybe even a “Use default site logos” checkbox?! (I hope to contribute to this kind of thing soon, but above my coding pay grade at the moment. Thank you for a wonderful component…

---

## [Icons not displaying in Brand Header?](https://meta.discourse.org/t/icons-not-displaying-in-brand-header/312730)

<div class="topic-metadata">

**Author:** [@DavidO](https://meta.discourse.org/u/DavidO)\
**Replies:** 6\
**Last updated:** [May 17, 2022, 7:40am UTC](https://meta.discourse.org/t/icons-not-displaying-in-brand-header/312730 "2022-05-17T07:40:56Z")

</div>

Is this still active? I’m having issues with icons showing correctly. I have this in the settings… But this is what shows on the page… It’s just blank spots where the icons should be. The links are there if I mou…

---

## [Center logo horizontally and vertically on all devices](https://meta.discourse.org/t/center-logo-horizontally-and-vertically-on-all-devices/312729)

<div class="topic-metadata">

**Author:** [@falcon9](https://meta.discourse.org/u/falcon9)\
**Replies:** 1\
**Last updated:** [January 18, 2022, 4:34pm UTC](https://meta.discourse.org/t/center-logo-horizontally-and-vertically-on-all-devices/312729 "2022-01-18T16:34:00Z")

</div>

@vinothkannans How do I center the logo both horizontally and vertically on all devices? I don’t plan on using the links… just the logo.

---

## [Mobile Brand Header button background colour not right?](https://meta.discourse.org/t/mobile-brand-header-button-background-colour-not-right/312668)

<div class="topic-metadata">

**Author:** [@soraiden](https://meta.discourse.org/u/soraiden)\
**Replies:** 4\
**Last updated:** [January 3, 2021, 3:06am UTC](https://meta.discourse.org/t/mobile-brand-header-button-background-colour-not-right/312668 "2021-01-03T03:06:33Z")

</div>

My desktop version still looks stellar, but my mobile version has recently started displaying in this way. I know this was in the works for a future update, so it’s probably intentional. Is there a way to set my deskto…

---

## [Change background colour of Brand Header](https://meta.discourse.org/t/change-background-colour-of-brand-header/312667)

<div class="topic-metadata">

**Author:** [@salmanfarisvp](https://meta.discourse.org/u/salmanfarisvp)\
**Replies:** 2\
**Last updated:** [October 3, 2020, 5:55pm UTC](https://meta.discourse.org/t/change-background-colour-of-brand-header/312667 "2020-10-03T17:55:21Z")

</div>

How to change the background colour default blue to other?

---

## [Icons missing in Brand Header?](https://meta.discourse.org/t/icons-missing-in-brand-header/312666)

<div class="topic-metadata">

**Author:** [@Allted](https://meta.discourse.org/u/Allted)\
**Replies:** 2\
**Last updated:** [August 12, 2020, 10:17pm UTC](https://meta.discourse.org/t/icons-missing-in-brand-header/312666 "2020-08-12T22:17:27Z")

</div>

Hi, back with another question. My icons, and their links seem to be gone. I am on 2.5.0 stable. I checked desktop and mobile. I tried removing and replacing them, still no go. Any ideas?

---

## [Hiding Brand Header still leaves blank space?](https://meta.discourse.org/t/hiding-brand-header-still-leaves-blank-space/312665)

<div class="topic-metadata">

**Author:** [@sophspages](https://meta.discourse.org/u/sophspages)\
**Replies:** 2\
**Last updated:** [June 7, 2020, 1:09pm UTC](https://meta.discourse.org/t/hiding-brand-header-still-leaves-blank-space/312665 "2020-06-07T13:09:40Z")

</div>

Thank you for this great component! I don’t want it to show to non logged in users so I have added this in the CSS of the component: .b-header { display: block; } .anon .b-header { display: none; } It works but …

---

## [Broken logo thumbnail in Brand Header](https://meta.discourse.org/t/broken-logo-thumbnail-in-brand-header/312664)

<div class="topic-metadata">

**Author:** [@Michael\_SC](https://meta.discourse.org/u/Michael_SC)\
**Replies:** 3\
**Last updated:** [April 27, 2020, 7:26am UTC](https://meta.discourse.org/t/broken-logo-thumbnail-in-brand-header/312664 "2020-04-27T07:26:18Z")

</div>

I seem to be getting a broken thumbnail displaying on the menu whenever I write in the URL of the .jpg logo (the same .jpg logo I use on my Wordpress installation) in the configuration settings. Any idea what the issue …

---

## [Make Brand Header social icons visible in dark theme?](https://meta.discourse.org/t/make-brand-header-social-icons-visible-in-dark-theme/312663)

<div class="topic-metadata">

**Author:** [@Anatolia](https://meta.discourse.org/u/Anatolia)\
**Replies:** 4\
**Last updated:** [February 7, 2020, 10:21pm UTC](https://meta.discourse.org/t/make-brand-header-social-icons-visible-in-dark-theme/312663 "2020-02-07T22:21:12Z")

</div>

How can I make these social logos visible in a dark theme? I want them to have %100 opacity with white color.

---

## [Phantom link in Brand Header](https://meta.discourse.org/t/phantom-link-in-brand-header/312645)

<div class="topic-metadata">

**Author:** [@MarkTuff](https://meta.discourse.org/u/MarkTuff)\
**Replies:** 2\
**Last updated:** [October 15, 2019, 5:09pm UTC](https://meta.discourse.org/t/phantom-link-in-brand-header/312645 "2019-10-15T17:09:30Z")

</div>

Hi @vinothkannans, not sure why but I have a phantom link hover here. It doesn’t actually click through to anything. I don’t believe I have anything strange in the settings. Any ideas?

---

## [Using Facebook icon in Brand Header](https://meta.discourse.org/t/using-facebook-icon-in-brand-header/312644)

<div class="topic-metadata">

**Author:** [@smileypants707](https://meta.discourse.org/u/smileypants707)\
**Replies:** 6\
**Last updated:** [September 13, 2019, 4:23am UTC](https://meta.discourse.org/t/using-facebook-icon-in-brand-header/312644 "2019-09-13T04:23:26Z")

</div>

Hey there, so I can’t figure out what’s wrong here: I have this FB icon typed in correctly, But it is invisible in the header: The invisible icon takes me to the correct FB page if I click on it in the header, b…

---

## [Brand Header making main header jerky on scroll](https://meta.discourse.org/t/brand-header-making-main-header-jerky-on-scroll/312643)

<div class="topic-metadata">

**Author:** [@Jennifer\_Abrams](https://meta.discourse.org/u/Jennifer_Abrams)\
**Replies:** 8\
**Last updated:** [October 14, 2019, 1:58pm UTC](https://meta.discourse.org/t/brand-header-making-main-header-jerky-on-scroll/312643 "2019-10-14T13:58:01Z")

</div>

Does anyone know how to keep this new header from making the main header jerky when scrolling down? It will make the main discourse header dissapear then reappear quickly once when scrolling down for the first time afte…

---

## [Making Brand Header RTL compatible](https://meta.discourse.org/t/making-brand-header-rtl-compatible/312640)

<div class="topic-metadata">

**Author:** [@hosna](https://meta.discourse.org/u/hosna)\
**Replies:** 9\
**Last updated:** [April 10, 2019, 3:22pm UTC](https://meta.discourse.org/t/making-brand-header-rtl-compatible/312640 "2019-04-10T15:22:28Z")

</div>

How can we make this component to be compatible with RTL websites?

---

## [Hide Brand Header completely on mobiles](https://meta.discourse.org/t/hide-brand-header-completely-on-mobiles/312639)

<div class="topic-metadata">

**Author:** [@SMx](https://meta.discourse.org/u/SMx)\
**Replies:** 2\
**Last updated:** [April 4, 2019, 4:50pm UTC](https://meta.discourse.org/t/hide-brand-header-completely-on-mobiles/312639 "2019-04-04T16:50:37Z")

</div>

Hi there, an awesome component which makes a corporate forum so much better. One question, can this be hidden completely on mobile browsers from css? The double burger menus seems confusing for some users. Thank you.

---

## [Add icon next to header link text](https://meta.discourse.org/t/add-icon-next-to-header-link-text/312631)

<div class="topic-metadata">

**Author:** [@davidkingham](https://meta.discourse.org/u/davidkingham)\
**Replies:** 3\
**Last updated:** [July 31, 2018, 3:06am UTC](https://meta.discourse.org/t/add-icon-next-to-header-link-text/312631 "2018-07-31T03:06:43Z")

</div>

Would it be possible to add a font awesome icon next to the link similar to this?

---

## [Highlight current page in Brand Header links](https://meta.discourse.org/t/highlight-current-page-in-brand-header-links/312632)

<div class="topic-metadata">

**Author:** [@davidkingham](https://meta.discourse.org/u/davidkingham)\
**Replies:** 0\
**Last updated:** [July 2, 2018, 4:07am UTC](https://meta.discourse.org/t/highlight-current-page-in-brand-header-links/312632 "2018-07-02T04:07:41Z")

</div>

For those interested I was able to sort of achieve this, it’s not intelligent for what page you’re on, but for most, it will do the trick. Change the (2) to whatever position your forum button is .b-header .nav-pills \> …

---

## [Keep Brand Header static instead of scrolling?](https://meta.discourse.org/t/keep-brand-header-static-instead-of-scrolling/312630)

<div class="topic-metadata">

**Author:** [@cadriel](https://meta.discourse.org/u/cadriel)\
**Replies:** 4\
**Last updated:** [May 8, 2018, 11:49pm UTC](https://meta.discourse.org/t/keep-brand-header-static-instead-of-scrolling/312630 "2018-05-08T23:49:25Z")

</div>

Confirming; After installing this, it appears as though the header scrolls off the page. Is there a way to fix the header in place above the existing discourse header?

[Next page](https://meta.discourse.org/tag/brand-header/556.md?match_all_tags=true&page=1&tags%5B%5D=brand-header)
