Tag Banners

Theme component
,
1
:discourse2: Summary Tag Banners displays the tag name and description in a banner at the top of the page when visiting a tag-filtered topic list (similar to the Category Banners component)
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-tag-banners
:open_book: New to Discourse Themes? Beginnerā€™s guide to using Discourse Themes

Install this theme component

Features

tag banner
tag banner1228Ɨ343 18 KB

Developer Notes

You can customize these banners with CSS. Each banner gets the tag name(s) appended as a class, for example:

.tag-title-header.tag-banner-art {
  background: salmon;
  color: beige;
}

The banner also works with tag intersections (e.g., community.example.com/tags/intersection/art/new-tag)

tag intersection
tag intersection2334Ɨ890 171 KB

In this case, youā€™d target .tag-banner-art.tag-banner-new-tag for CSS customization.

Settings

Name Description
show on mobile Show tag banners on mobile devices
show tag description Show tag description when available
show above site header Display the banner in the above site header connector.
show below site header Display the banner in the below site header connector.
show above main container Display the banner in the above main container connector, for sites with the sidebar enabled.
remove tag hyphen Remove hyphens from tag names in banners
remove tag underscore Remove underscores from tag names in banners
hide tag icon Hide the tag icon when used along with category banners
show with category banners Show full banner alongside category banners

:discourse2: Hosted by us? Theme components are available to use on our Pro, Business and Enterprise plans.

Last edited by @tobiaseigen 2025-06-24T03:17:47Z

Check documentPerform check on document:
41 Likes
39

A post was split to a new topic: ā€˜tag-bannerā€™ class not being removed when navigating away

40

Bug: "Required" category of a tag not showing up under "category ..." dropdown

Summary: When creating a new topic from the homepage, all category options surface in the composerā€”as expected. But when you click into a tag (i.e. navigate to /tag/tag-name), and attempt to compose a new post from that page, all categories surfaceā€”except, ironically, the category that has set that particular tag among its requirements.

This problem stopped when disabling this component.

2 Likes
41

Would it be easy to cook the tag description in the banner? (Or in normal tag descriptions anyway?)

I find this useful to be able to send to topics or categories, or to indicate another related tagā€¦ But without cooking, itā€™s not doable.

Thanks! :purple_heart:

42

Digging out this one :shovel: :smiley:

By ā€œcookingā€, that would basically mean to render markdown, emojis etc? That would be a great addition!

2 Likes
43

If Iā€™m not wrong, you can use HTML in the descriptions and it should be rendered.

1 Like
44

It would be great to have it consistent across tag/category banners and category descriptions. HTML is workable, but feels very hacky!

3 Likes
45

I agree on this one

In this context any way to also render the icons added via tag icon component inside the tag banner?

46

There is a hide tag icon setting. Could that be it?

47

The setting is to Hide the tag icon when used along with category banners. No tag icons are being displayed whether itā€™s enabled or disabled. Whether with or without category selected simultaneously.
Tested on 3.5.0 stable