Tag Icons

Theme component
,
1
:discourse2: Summary Tag Icons allows tags to have an icon next to the tag label.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-tag-icons
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

Here is an example of how this would look, with tag style set to the default (simple):

image
image1566Ă—180 31.5 KB

Here is how this looks with tag style set to box:

image
image1364Ă—122 30.3 KB

Settings

Name Description
tag icon list Enter comma-delimited configuration for tags, in the format “tag-slug,icon,iconColor”. Icon color is optional.
svg icons List of FontAwesome 6 icons used in this theme component

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

Last edited by @tobiaseigen 2025-08-27T06:57:11Z

Check documentPerform check on document:
79 Likes
Is anyone else using tags on a Discourse forum in a big way?
Events Plugin :calendar:
Discourse Coloring Tag
Category Icons
How to test themes or theme components?
How to make a category-list-like front page for a tag-oriented site?
Request or idea for a component: topic title or topic flair
Admin guide to tags in Discourse
Customizing your site with existing theme components
Category Icons
Setup Continuous Integration using GitHub Actions
Tag change color for element in a Tag group
Add color and subcategory styling to category and chat mentions
Setting tag style to 'box'?
MD Topic List component
Remove Dashes from Tag Names
MD Topic List Mobile component
Links in tag descriptions aren’t escaped when using Tag Icons
Good approach for data sensitivity markings?
We're upgrading our icons to Font Awesome 6!
Include an emoji when creating a new topic?
For newly created labels, assign a random style
(Superseded) Add a custom fontawesome icon and color to your tag
How to create a tag "🎥"?
How to create a tag "🎥"?
Does anyone know how to add emojis to tags?
Renaming Tags: Consequences
Workarounds to support alternate tag structures
Difficult contrast of tags and categories when the text colour is white
Tag Banners
Looking for a freelancer to implement a custom Discourse theme (based on an existing mockup)
Some of my tags have # and some don't
The Horizon theme does not display tags on topic lists
Default tag icon
Tag Icons + Tag Banners + Right Sidebar Blocks
Volunteer Activities - a simple setup for non-hierarchical collaboration
api.onPageChange not working with endless scroll
Add backgroundColor option for Tag Icons theme-component
A picker for font awesome icons
Uncaught TypeError: Cannot read property 'apply' of undefined
Workarounds to support alternate tag structures
Javascript error + content missing after update 2.6.0.beta3
Trying to use css to insert png icons in tag boxes
Emoji in tag - thoughts and experiences
A playful approach to category moderation