# Brand Navigation **URL:** \ **Category:** Theme component\ **Created:** [October 23, 2026, 8:15am UTC](https://meta.discourse.org/t/brand-navigation/415541 "2026-10-23T08:15:13Z")\ **Posts on this page:** 1\ **Showing post:** 1
**Author:** ![philh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/philh/32/532740_2.png) [@philh](https://meta.discourse.org/u/philh)\ **Post date:** [October 23, 2026, 8:15am UTC](https://meta.discourse.org/t/brand-navigation/415541/1 "2026-10-23T08:15:13Z")
# Brand Navigation — branded menus and header links | | | | | --- | --- | --- | | ℹ | **Summary** | **Brand Navigation** adds a branded navigation bar with direct links and dropdown menus, and adds optional text and icon links to Discourse’s header. | | 👓 | **Preview** | [Screenshots and live examples](https://docs.codeworkslabs.dev/brand-navigation/preview/) | | 🛠 | **Repository** | [CodeWorksLabs/brand-navigation](https://github.com/CodeWorksLabs/brand-navigation) | | ❓ | **Install Guide** | [How to install a theme or theme component](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) | | 📖 | **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 Brand Navigation gives your community a branded navigation bar for links to your website, community resources and related projects. It supports dropdown menus and can also place direct text or icon links in Discourse’s own header. ## Examples **The Bridge:** a navigation bar above the forum header, with additional links beside Discourse’s header controls. ![Brand Navigation on The Bridge](https://global.discourse-cdn.com/meta/original/4X/c/f/b/cfb32568ef30f4ee63613a8611f364a77c0dc8f0.jpeg) **Repeal OBBBA Forum:** a red navigation bar with community menus and social links in the Discourse header. ![Brand Navigation on Repeal OBBBA Forum](https://global.discourse-cdn.com/meta/original/4X/1/a/5/1a5b4c7ad7fb8982b1dc130a94dd995364a12c32.jpeg) ## Features - **Brand identity:** show a name, logo, or both, with separate light and dark logos. Place the bar above or below the Discourse header. - **Links and menus:** add direct links and one level of submenus. A parent can link to a page with a separate menu arrow, or act only as a submenu button. Items can include icons and optional submenu descriptions. - **Header links:** place social links, forum links and external links in Discourse’s core header. - **Audience and device controls:** show items to everyone, signed-in visitors, or signed-out visitors, and choose desktop or mobile visibility. - **Mobile layouts:** use a compact menu, a full bar, or hide the component on mobile. - **Appearance and configuration:** inherit Discourse’s palette or set component colors, adjust header-link text and icon sizes, reorder items in the structured editor, and export or import a JSON configuration. ## Getting started [Install Brand Navigation](https://docs.codeworkslabs.dev/brand-navigation/install/) · [Add links, menus and colors](https://docs.codeworkslabs.dev/brand-navigation/configure/) · [Back up or move settings](https://docs.codeworkslabs.dev/brand-navigation/configuration-bundles/) ## Status [![Release v1.0.0-rc.5](https://global.discourse-cdn.com/meta/original/4X/3/e/8/3e8850faaf13d2bd31eb57b54c06a55f50da17b6.svg)](https://github.com/CodeWorksLabs/brand-navigation/releases/tag/v1.0.0-rc.5) is available as a prerelease. See [known issues](https://github.com/CodeWorksLabs/brand-navigation/blob/main/docs/KNOWN_ISSUES.md) and the [testing record](https://docs.codeworkslabs.dev/brand-navigation/source/testing-record/) for details. ## Feedback and support Questions, screenshots and configuration ideas are welcome in this topic. For installation, configuration and troubleshooting help, start a topic in [Brand Navigation Support](https://forum.codeworkslabs.dev/c/brand-navigation/support/7) on the CodeWorksLabs Forum. Bugs, compatibility reports and documentation corrections can also be filed through [GitHub Issues](https://github.com/CodeWorksLabs/brand-navigation/issues). ## Roadmap and feature requests Follow the [Brand Navigation roadmap](https://forum.codeworkslabs.dev/t/brand-navigation-roadmap/14) for proposed, planned, in-progress and released work. Have an idea for improving Brand Navigation? Share it in [Feature Requests](https://forum.codeworkslabs.dev/c/brand-navigation/feature-requests/8). Brand Navigation is independently maintained by CodeWorksLabs and licensed under **GPL-2.0-or-later**. ## Thanks Thanks to the authors of [Discourse Brand Header](https://github.com/discourse/discourse-brand-header), [Discourse Header Submenus](https://github.com/discourse/discourse-header-submenus), [Custom Header Links (icons)](https://github.com/discourse/discourse-icon-header-links), and Pavilion’s [Dropdown Header](https://github.com/paviliondev/discourse-dropdown-header) for the ideas and examples that informed Brand Navigation. See [attribution and licensing](https://github.com/CodeWorksLabs/brand-navigation/blob/main/docs/ATTRIBUTION.md) and the [authorship and provenance record](https://github.com/CodeWorksLabs/brand-navigation/blob/main/docs/PROVENANCE.md) for the full credits. --- _[View the full topic](https://meta.discourse.org/t/brand-navigation/415541)._