# \#tag-icons

**URL:** https://meta.discourse.org/tag/tag-icons/598.md

[Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md)

---

## [Tag Icons suddenly converting underscores to dashes in slugs, breaking the icon](https://meta.discourse.org/t/tag-icons-suddenly-converting-underscores-to-dashes-in-slugs-breaking-the-icon/403428)

<div class="topic-metadata">

**Author:** [@AquaL1te](https://meta.discourse.org/u/AquaL1te)\
**Replies:** 5\
**Last updated:** [August 24, 2026, 10:37am UTC](https://meta.discourse.org/t/tag-icons-suddenly-converting-underscores-to-dashes-in-slugs-breaking-the-icon/403428 "2026-08-24T10:37:55Z")

</div>

I’ve set the following, and that worked really well. But since a few weeks it doesn’t work well anymore. So these tags should all look like below, and they do, in the sidebar, but not in topics. So as you can see…

---

## [Missing tag icons on Category Groups](https://meta.discourse.org/t/missing-tag-icons-on-category-groups/410697)

<div class="topic-metadata">

**Author:** [@satonotdead](https://meta.discourse.org/u/satonotdead)\
**Replies:** 0\
**Last updated:** [August 22, 2026, 4:45pm UTC](https://meta.discourse.org/t/missing-tag-icons-on-category-groups/410697 "2026-08-22T16:45:38Z")

</div>

It seems that something is missing here; the code does not output the icons in the category descriptions after enabling Category Groups. This is good and expected: NOTE: Bitcoin icon also does not look right; I also…

---

## [Tag-icons plugin icon display issue](https://meta.discourse.org/t/tag-icons/409042)

<div class="topic-metadata">

**Author:** [@iouvps](https://meta.discourse.org/u/iouvps)\
**Replies:** 4\
**Last updated:** [August 1, 2026, 2:29pm UTC](https://meta.discourse.org/t/tag-icons/409042 "2026-08-01T14:29:24Z")

</div>

\[ { "setting": "tag\_icon\_list", "value": "Tutorial,book-open-reader,#A8C6FE|Review,bug,#669d34|Announcement,bullhorn,#BF1E2E|Node,network-wired,#669d34|Feedback,flag,#669d34|Telegram,paper-plane,#12A89D|Github,fab-github,#12A89D|toapi,hammer…"

---

## [Tag Icons](https://meta.discourse.org/t/tag-icons/109757)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 91\
**Last updated:** [March 3, 2026, 11:39pm UTC](https://meta.discourse.org/t/tag-icons/109757 "2026-03-03T23:39:55Z")

</div>

: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/d…

---

## [Add support for translated tags to the tag icon component](https://meta.discourse.org/t/add-support-for-translated-tags-to-the-tag-icon-component/399594)

<div class="topic-metadata">

**Author:** [@Moin](https://meta.discourse.org/u/Moin)\
**Replies:** 4\
**Last updated:** [April 3, 2026, 3:24am UTC](https://meta.discourse.org/t/add-support-for-translated-tags-to-the-tag-icon-component/399594 "2026-04-03T03:24:58Z")

</div>

Tag icons seem to work only on tags where the translation is identical to the English version of the tag. I think it would be helpful if it worked for translated tags too, especially here on Meta where tag icons add a lo…

---

## [Support tag icons for translated tags in tag banners](https://meta.discourse.org/t/support-tag-icons-for-translated-tags-in-tag-banners/399840)

<div class="topic-metadata">

**Author:** [@Moin](https://meta.discourse.org/u/Moin)\
**Replies:** 0\
**Last updated:** [April 2, 2026, 9:00pm UTC](https://meta.discourse.org/t/support-tag-icons-for-translated-tags-in-tag-banners/399840 "2026-04-02T21:00:38Z")

</div>

In the English version of the combined tag and category banner the tag icon is shown in front of the tag: This is not the case for the translated tag:

---

## [Feedback? Attempted combo of Remove Dashes from Tags, Tag Styles, and Tag Icons](https://meta.discourse.org/t/feedback-attempted-combo-of-remove-dashes-from-tags-tag-styles-and-tag-icons/397792)

<div class="topic-metadata">

**Author:** [@jdc20181](https://meta.discourse.org/u/jdc20181)\
**Replies:** 0\
**Last updated:** [March 6, 2026, 5:59am UTC](https://meta.discourse.org/t/feedback-attempted-combo-of-remove-dashes-from-tags-tag-styles-and-tag-icons/397792 "2026-03-06T05:59:12Z")

</div>

I came across a few very useful theme components the other day which were Remove Tag Dashes, Tag Styles, and Tag Icons. But in adoption of all 3, I had some cross-compatibility issues. So, I attempted, to make a consolid…

---

## [Inconsistent tag icon color in combined category/tag banners](https://meta.discourse.org/t/inconsistent-tag-icon-color-in-combined-category-tag-banners/395323)

<div class="topic-metadata">

**Author:** [@Moin](https://meta.discourse.org/u/Moin)\
**Replies:** 0\
**Last updated:** [February 5, 2026, 9:14pm UTC](https://meta.discourse.org/t/inconsistent-tag-icon-color-in-combined-category-tag-banners/395323 "2026-02-05T21:14:17Z")

</div>

In a combined category and tag banner, the tag icon does not use the same color as the text. In light mode, this is a problem if the banner is dark, so the text is white. And in dark mode, you can see a light icon o…

---

## [Discourse update causes homepage layout issues](https://meta.discourse.org/t/discourse/394394)

<div class="topic-metadata">

**Author:** [@祁同伟](https://meta.discourse.org/u/%E7%A5%81%E5%90%8C%E4%BC%9F)\
**Replies:** 16\
**Last updated:** [January 28, 2026, 12:14am UTC](https://meta.discourse.org/t/discourse/394394 "2026-01-28T00:14:22Z")

</div>

Domain name: qingju.me

---

## [Add backgroundColor option for Tag Icons theme-component](https://meta.discourse.org/t/add-backgroundcolor-option-for-tag-icons-theme-component/391995)

<div class="topic-metadata">

**Author:** [@gormus](https://meta.discourse.org/u/gormus)\
**Replies:** 2\
**Last updated:** [January 26, 2026, 4:14pm UTC](https://meta.discourse.org/t/add-backgroundcolor-option-for-tag-icons-theme-component/391995 "2026-01-26T16:14:16Z")

</div>

The Tag Icons theme-component allows configuring tags to be displayed with an icon, and an optional color. I really think this feature makes a difference, especially when you have to manage too many tags. In my case, us…

---

## [Is something missing?](https://meta.discourse.org/t/is-something-missing/392128)

<div class="topic-metadata">

**Author:** [@Salocin](https://meta.discourse.org/u/Salocin)\
**Replies:** 2\
**Last updated:** [December 25, 2025, 9:30pm UTC](https://meta.discourse.org/t/is-something-missing/392128 "2025-12-25T21:30:43Z")

</div>

Is there supposed to be something in front of his tags? An icon maybe? Completed, Fixed, Official

---

## [Tag Icons + Tag Banners + Right Sidebar Blocks](https://meta.discourse.org/t/tag-icons-tag-banners-right-sidebar-blocks/391775)

<div class="topic-metadata">

**Author:** [@Hyteller](https://meta.discourse.org/u/Hyteller)\
**Replies:** 0\
**Last updated:** [December 19, 2025, 7:18pm UTC](https://meta.discourse.org/t/tag-icons-tag-banners-right-sidebar-blocks/391775 "2025-12-19T19:18:42Z")

</div>

Would be great to see Tag Icons working with Tag Banners and Right Sidebar Blocks (“Popular Tags” block).

---

## [Default tag icon](https://meta.discourse.org/t/default-tag-icon/391774)

<div class="topic-metadata">

**Author:** [@Hyteller](https://meta.discourse.org/u/Hyteller)\
**Replies:** 0\
**Last updated:** [December 19, 2025, 7:17pm UTC](https://meta.discourse.org/t/default-tag-icon/391774 "2025-12-19T19:17:22Z")

</div>

Can you please add option to set default Tag Icons for all tags that do not have a specific icon?

---

## [Tag Icons working with tag groups](https://meta.discourse.org/t/tag-icons-working-with-tag-groups/272374)

<div class="topic-metadata">

**Author:** [@fellowshipforums](https://meta.discourse.org/u/fellowshipforums)\
**Replies:** 7\
**Last updated:** [October 2, 2025, 5:08pm UTC](https://meta.discourse.org/t/tag-icons-working-with-tag-groups/272374 "2025-10-02T17:08:52Z")

</div>

Wow, this is awesome! Can this be expanded to work with tag groups? (All tags within a specific tag group would get a specific icon)

---

## [Tag icon doesn't appear in the hashtag autocomplete](https://meta.discourse.org/t/tag-icon-doesnt-appear-in-the-hashtag-autocomplete/354872)

<div class="topic-metadata">

**Author:** [@Arkshine](https://meta.discourse.org/u/Arkshine)\
**Replies:** 0\
**Last updated:** [February 27, 2025, 4:59pm UTC](https://meta.discourse.org/t/tag-icon-doesnt-appear-in-the-hashtag-autocomplete/354872 "2025-02-27T16:59:44Z")

</div>

This is not a bug in the component per se. The component relies on the hashtag slug: But core doesn’t pass the slug param in generateIconHTML function \[1\]. It doesn’t appear to be a regression, I assume there was n…

---

## [Trouble with new Fontawesome 6 icons in theme components](https://meta.discourse.org/t/trouble-with-new-fontawesome-6-icons-in-theme-components/328165)

<div class="topic-metadata">

**Author:** [@traceymoko](https://meta.discourse.org/u/traceymoko)\
**Replies:** 7\
**Last updated:** [September 26, 2024, 7:59am UTC](https://meta.discourse.org/t/trouble-with-new-fontawesome-6-icons-in-theme-components/328165 "2024-09-26T07:59:29Z")

</div>

split from We're upgrading our icons to Font Awesome 6! - #26 : Thanks for letting me know. But I was referring to the names specifically: I’ve been using the theme components and they still use the FA5 names. I tried…

---

## [Tag icons don't show up in post text](https://meta.discourse.org/t/tag-icons-dont-show-up-in-post-text/315852)

<div class="topic-metadata">

**Author:** [@nathank](https://meta.discourse.org/u/nathank)\
**Replies:** 1\
**Last updated:** [July 16, 2024, 1:34am UTC](https://meta.discourse.org/t/tag-icons-dont-show-up-in-post-text/315852 "2024-07-16T01:34:46Z")

</div>

Continuing the discussion from Icons don't show up in post text: It seems odd to me that we don’t have the Tag icons (i.e. tag-icons) also appearing in the text of posts. I’m not sure if this is a regression or a featu…

---

## [Links in tag descriptions aren’t escaped when using Tag Icons](https://meta.discourse.org/t/links-in-tag-descriptions-aren-t-escaped-when-using-tag-icons/285942)

<div class="topic-metadata">

**Author:** [@JammyDodger](https://meta.discourse.org/u/JammyDodger)\
**Replies:** 5\
**Last updated:** [November 20, 2023, 6:14pm UTC](https://meta.discourse.org/t/links-in-tag-descriptions-aren-t-escaped-when-using-tag-icons/285942 "2023-11-20T18:14:36Z")

</div>

When adding a tag description to a link here on meta the tag display borks out:

---

## [Tag with tag icon shows general and specific icon in search](https://meta.discourse.org/t/tag-with-tag-icon-shows-general-and-specific-icon-in-search/284159)

<div class="topic-metadata">

**Author:** [@Moin](https://meta.discourse.org/u/Moin)\
**Replies:** 0\
**Last updated:** [November 1, 2023, 9:54pm UTC](https://meta.discourse.org/t/tag-with-tag-icon-shows-general-and-specific-icon-in-search/284159 "2023-11-01T21:54:08Z")

</div>

Is it intentional that the specific tag icon and the general tag icon are shown while searching? Usually it is either welcome-link-banner or . So it is a little confusing to have both icons at the same time.

---

## [Tag icons not appearing in the navigation sidebar](https://meta.discourse.org/t/tag-icons-not-appearing-in-the-navigation-sidebar/271392)

<div class="topic-metadata">

**Author:** [@eddowding](https://meta.discourse.org/u/eddowding)\
**Replies:** 3\
**Last updated:** [July 19, 2023, 2:54pm UTC](https://meta.discourse.org/t/tag-icons-not-appearing-in-the-navigation-sidebar/271392 "2023-07-19T14:54:20Z")

</div>

In meta.discourse.org the icon shows up in the tag navigation on the left. When I try it, it doesn’t. It does show up correctly in the topic lists, etc. Just not in the navigation sidebar. What am I missing? Thanks!

---

## [How to hide icons to visitors?](https://meta.discourse.org/t/how-to-hide-icons-to-visitors/271401)

<div class="topic-metadata">

**Author:** [@Jagster](https://meta.discourse.org/u/Jagster)\
**Replies:** 1\
**Last updated:** [February 13, 2023, 2:07pm UTC](https://meta.discourse.org/t/how-to-hide-icons-to-visitors/271401 "2023-02-13T14:07:04Z")

</div>

Is there any decently easy way not to show icons to random visitors? I’m using icons more contentually than just showing decorations (I would like to think that way :wink: ), like giving an easy and general content warn…

---

## [Matching wrong tag to tag icon](https://meta.discourse.org/t/matching-wrong-tag-to-tag-icon/272395)

<div class="topic-metadata">

**Author:** [@e3hines](https://meta.discourse.org/u/e3hines)\
**Replies:** 6\
**Last updated:** [May 18, 2021, 6:38pm UTC](https://meta.discourse.org/t/matching-wrong-tag-to-tag-icon/272395 "2021-05-18T18:38:13Z")

</div>

First, just wanted to say thanks for this awesome component. It’s really helped categorize and easily distinguish between tags and ultimately, categories. Our community has given amazing feedback around this component, s…

---

## [Does icon font awesome work?](https://meta.discourse.org/t/does-icon-font-awesome-work/137975)

<div class="topic-metadata">

**Author:** [@eextra](https://meta.discourse.org/u/eextra)\
**Replies:** 3\
**Last updated:** [January 7, 2020, 5:46pm UTC](https://meta.discourse.org/t/does-icon-font-awesome-work/137975 "2020-01-07T17:46:14Z")

</div>

trying to implement according to the guide but I can’t manage fo example: I type the tag here and here but unfortunately it doesn’t work. I turned the component correctly

---

## [Issue using custom icon with Tag Icons](https://meta.discourse.org/t/issue-using-custom-icon-with-tag-icons/272372)

<div class="topic-metadata">

**Author:** [@kristof\_mulier](https://meta.discourse.org/u/kristof_mulier)\
**Replies:** 2\
**Last updated:** [December 19, 2019, 5:01am UTC](https://meta.discourse.org/t/issue-using-custom-icon-with-tag-icons/272372 "2019-12-19T05:01:19Z")

</div>

Hi @pmusaraj , I’ve installed the Tag icons theme component. These are my current settings: I’ve defined three tags that are attached to a Font Awesome icon: bug-showstopper attached to skull-crossbone bug-major …

---

## [Setting tag style to 'box'?](https://meta.discourse.org/t/setting-tag-style-to-box/272373)

<div class="topic-metadata">

**Author:** [@Atreus](https://meta.discourse.org/u/Atreus)\
**Replies:** 2\
**Last updated:** [September 30, 2019, 2:18pm UTC](https://meta.discourse.org/t/setting-tag-style-to-box/272373 "2019-09-30T14:18:16Z")

</div>

Can someone explain how to set this? I have them displaying as icons fine but I want the box around them.

---

## [Choosing the right icons](https://meta.discourse.org/t/choosing-the-right-icons/272391)

<div class="topic-metadata">

**Author:** [@debryc](https://meta.discourse.org/u/debryc)\
**Replies:** 3\
**Last updated:** [June 21, 2019, 6:16pm UTC](https://meta.discourse.org/t/choosing-the-right-icons/272391 "2019-06-21T18:16:24Z")

</div>

This is wonderful, thank you! How do you set which style of an icon to choose? For example, the Font Awesome icon “copyright” has a solid and regular form. I’d like to use the solid one. What do I do if an icon doesn’t…
