Brand Navigation · Discourse theme component

Your brand.
Clear navigation.

Give your Discourse community a recognizable identity. Add a branded navigation bar with useful links and dropdown menus, plus optional links and icons in the forum’s own header.

Independently maintained by CodeWorksLabs. Not an official Discourse product.

What you can do

Your links.
In the right places.

01

Make the forum yours

Show your brand name, logo, or both above or below Discourse’s header. Use separate logos for light and dark themes.

02

Organize links into menus

Add direct links and one level of dropdowns, with text, icons and optional descriptions. A linked parent can open a page while its arrow opens the menu.

03

Choose what visitors see

Show items to everyone, signed-in members or signed-out visitors, and choose desktop or mobile visibility. On phones, use a compact menu, a wrapping bar, or hide the bar.

04

Add links to the forum header

Place optional text links, icons, or both beside the forum logo or before the native controls. Choose left or right alignment and same-tab or new-tab behavior.

05

Match your theme—or customize it

Inherit theme colors, use the Appearance color pickers, or enter hex colors directly. Set normal and hover colors, plus independent desktop and mobile sizes for header links and icons.

06

Manage and reuse your setup

Edit Menu item and Submenu item rows in Discourse. Export a configuration backup or import it on another forum, and customize interface wording through Theme translations.

Preview

See it on
real communities.

These desktop screenshots show Brand Navigation in use while signed in. Open a screenshot for a closer look, or visit the community. Live navigation may change.

Repeal OBBBA Forum

Visit the site ↗
Repeal OBBBA Forum with a red navigation bar, dropdown menus and social icons in the forum header.

The Bridge demonstration site

Visit the site ↗
The Bridge with publishing menus, a Versions & Status text link and icons in the forum header.

RVing Community

Visit the site ↗
RVing Community with a blue navigation bar, community menus and its own forum logo.

DiscussionBridge Forum

Visit the site ↗
DiscussionBridge Forum with product, documentation and community navigation above its forum header.

Inside the administration settings

Compact previews—select either image to open the full-size screenshot in a new tab.

Preview of Brand Navigation’s component settings.

Component settings

Branding, colors, sizes, Appearance and configuration backups.

Preview of Brand Navigation’s navigation-items editor.

Navigation-items editor

Menus, submenu items, placement, link behavior and ordering.

Read the settings reference →

Installation

Set it up.
Make it yours.

https://github.com/CodeWorksLabs/brand-navigation.git

In Discourse, install a component from this Git repository. Attach it to a non-default staging theme, turn Enabled? on, then configure and preview it before using it on your live theme.

Follow the installation guide →

Help and ideas

A place to ask.
A place to contribute.

Try it with your theme first.

RC4 is a release candidate. Preview your navigation on desktop and mobile, keep labels short, and back up your settings before updating. See tested Discourse versions and compatibility guidance for the current checks and limits.