# Tag Banners
**URL:** https://meta.discourse.org/t/tag-banners/124240
**Category:** Theme component
**Tags:** official, tag-banners
**Created:** [July 29, 2019, 2:32am UTC](https://meta.discourse.org/t/tag-banners/124240 "2019-07-29T02:32:39Z")
**Posts on this page:** 10
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [July 29, 2019, 2:32am UTC](https://meta.discourse.org/t/tag-banners/124240/1 "2019-07-29T02:32:39Z")
| | | |
| --- | --- | --- |
| :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](https://meta.discourse.org/t/discourse-category-banners/86241) component) |
| š | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/tag-banners) |
| š | **Repository Link** | [https://github.com/discourse/discourse-tag-banners](https://github.com/discourse/discourse-tag-banners) |
| š | **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
> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started. š
>
> [ā **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=tag-banners "Ask for support on configuring and using Tag Banners") [š **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=tag-banners "A bug report means something is broken, preventing normal/typical use of the theme component") [š **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=tag-banners "Discussion about the user interface of Tag Banners, and how features are presented (including language and UI elements)") [š” **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=tag-banners "Discussion about how existing Tag Banners features can be improved or enhanced, and how proposed new features could work")
### Features
### Developer Notes
You can customize these banners with CSS. Each banner gets the tag name(s) appended as a class, for example:
```plaintext
.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`)
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 document**
> >
> > Perform check on document:
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [July 5, 2023, 10:38am UTC](https://meta.discourse.org/t/tag-banners/124240/39 "2023-07-05T10:38:19Z")
A post was split to a new topic: [ātag-bannerā class not being removed when navigating away](https://meta.discourse.org/t/tag-banner-class-not-being-removed-when-navigating-away/270629)
---
### Author:  [@ncaming215](https://meta.discourse.org/u/ncaming215)
#### Post date: [June 24, 2024, 6:12pm UTC](https://meta.discourse.org/t/tag-banners/124240/40 "2024-06-24T18:12:03Z")
Bug: ["Required" category of a tag not showing up under "category ..." dropdown](https://meta.discourse.org/t/required-category-of-a-tag-not-showing-up-under-category-dropdown/313410/)
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.
---
### Author:  [@hellekin](https://meta.discourse.org/u/hellekin)
#### Post date: [April 5, 2025, 5:16pm UTC](https://meta.discourse.org/t/tag-banners/124240/41 "2025-04-05T17:16:09Z")
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! š
---
### Author:  [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [September 26, 2025, 11:04am UTC](https://meta.discourse.org/t/tag-banners/124240/42 "2025-09-26T11:04:17Z")
> [@hellekin](#):
>
> Would it be easy to _cook_ the tag description in the banner? (Or in normal tag descriptions anyway?)
Digging out this one šŖ š
By ācookingā, that would basically mean to render markdown, emojis etc? That would be a great addition!
---
### Author:  [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)
#### Post date: [September 26, 2025, 1:53pm UTC](https://meta.discourse.org/t/tag-banners/124240/43 "2025-09-26T13:53:07Z")
If Iām not wrong, you can use HTML in the descriptions and it should be rendered.
>
---
### Author:  [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [September 27, 2025, 8:06am UTC](https://meta.discourse.org/t/tag-banners/124240/44 "2025-09-27T08:06:47Z")
It would be great to have it consistent across tag/category banners and category descriptions. HTML is workable, but feels very hacky!
---
### Author:  [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [September 29, 2025, 1:22pm UTC](https://meta.discourse.org/t/tag-banners/124240/45 "2025-09-29T13:22:45Z")
I agree on this one
In this context any way to also render the icons added via tag icon component inside the tag banner?
> [@Tag Icons](https://meta.discourse.org/t/tag-icons/109757):
>
> discourse2Summary Tag Icons allows tags to have an icon next to the tag label.eyeglassesPreview [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/tag-icons)hammer_and_wrenchRepository Link [https://github.com/discourse/discourse-tag-icons](https://github.com/discourse/discourse-tag-icons)open_bookNew 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 Features Here is an example of how this would look, with tag style set to the default (simple): Here is how this looks with tag styā¦
---
### Author:  [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)
#### Post date: [September 29, 2025, 10:52pm UTC](https://meta.discourse.org/t/tag-banners/124240/46 "2025-09-29T22:52:32Z")
There is a `hide tag icon` setting. Could that be it?
---
### Author:  [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [September 30, 2025, 6:45am UTC](https://meta.discourse.org/t/tag-banners/124240/47 "2025-09-30T06:45:10Z")
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