אייקוני קטגוריות

:warning:
This theme component is deprecated and should no longer be used. Its features are now in Discourse Core (see: Bringing popular features to Discourse).
For private category icon customization, refer to this topic.

:discourse2: Summary Category Icons allows category badge links to have icons next to the category name.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-category-icons
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

:information_source: This theme component is used alongside the Category Badge Styles theme component

Here is an example of how this would look, with category badge style set to none:

Here is how this would look with category badge style set to box:

Configuration is pretty straightforward:

Note that this component also lets you override the category lock icon used to denote private categories.

:information_source: See also the Tag Icons component (which does the same thing for tags).

Settings

Name Description
category icon list The list of categories and their respective icons
svg icons Add extra icons not included by default
category lock icon The icon to replace the ‘category lock icon’
  • To add an icon to a category, enter the details separated by commas like so “slug,icon,color,match”
  • Colour is in the format #123456, or “categoryColor” to use the default color for the category (same as the Badge color)
  • If match is “partial” then the slug need only partially match the category-slug, otherwise an exact match is required.

Issues

  • Does not correctly respect the icon color when using with the bullet category style. In general, though, this shouldn’t be used with the bullet or bar category styles as the UI would be unnecessarily busy.

Development history

Thanks to @rogerco, for adding the “partial” keyword to partially match category slugs (i.e. entering “book,icon,red,partial” would match all category slugs containing “book”). :trophy: :clap:

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

Last edited by @dax 2025-07-14T17:39:05Z

Check documentPerform check on document:
84 לייקים
Bringing popular features to Discourse: Header search, welcome banner, and category icons / emoji
How to display font awesome icons alongside category?
Put an emoji in the category
Ability to display category icons in sidebar
[PAID] Assistance to Set-up My Forum
Duplicate icons on categories page
Icons next to categories
Amazing customized community
Alternatives to padlock icons on secured categories
Amazing customized community
Icons next to categories
Hide Lock Badge Icon
Discourse Category Headers theme component
Our new Basic Plan is now available. Try it out today!
Styling the sidebar without using CSS?
Moving to a Single Category Style Site Setting
How can I put custom icons next to categories?
Duplicated icon in composer's category dropdown
Moving to a Single Category Style Site Setting
We're upgrading our icons to Font Awesome 6!
Private categories padlock icon
Hide Lock Badge Icon
Flag icon before name in subcategory (bullets)
Subcategories only show up after refresh and a few other issues
(板块分类)How to set up board categories similar to the Fit2Cloud forum in Discourse?
Category Icons color and size is not being inherited correctly
How to change category title icon?
Ability to display category icons in sidebar
What are good plugins or theme components for a forum emphasizing pictures?
Suggestions for achieving a custom layout without having to code everything
Hide Lock Badge Icon
How to show category image before category name on listing pages?
Create a category in Discourse
Howto: Change lock icon for restricted categories
Categories: public vs. logged in only vs. restricted
Can the background color in front of the navs in the sidebar be changed to a small icon?
Unable to alter the lock icon in category boxes
Theme component to use "Category icons" in "Events plugin" calendar
Is there a plugin of some sort to have an Icon next to a category?
Looking for a freelancer to implement a custom Discourse theme (based on an existing mockup)
How to add customs icon with Category Icons Theme components now that we can't upload files into TC
Uncaught TypeError: Cannot read property 'apply' of undefined
Category Banners
Removing the legacy hamburger navigation menu option
Category color selection should be allowed even when style is "none"
How to use icons in my javascript?
How to display font awesome icons alongside category?
Category color selection should be allowed even when style is "none"
Removing the legacy hamburger navigation menu option

This component has had an impact on our forum in an artistic way. I like it.

However there is a problem with category names. I created a category with the name of “Doğa Bilimleri”, but later changed its name to “Bilim” and created a sub-category with the name of “Doğa Bilimleri”.

Before:
Before

After:
After

I only assigned an icon for the category of “Doğa Bilimleri”, not for “Bilim”.

doga-bilimleri-flask

But the flask icon has been assigned for both “Bilim” and its sub-category “Doğa Bilimleri”.

Flask-assigned-for-both

I cannot also assign an icon to a category whose name I change if I use the new name of it, yet the old name always works. (I solved this one: This is all about “category slug”. If you leave the category slug with the old name, you will experience same pseudo-problem.)

Edit: I figured out why the flask icon is assigned for the main category. It is because both the main category and the sub-category include same word “Bilim”. Even if I give a random name like “abcdefbilimghjk” in the category icon list, it will still assign the icon I choose to the category “Bilim”, since the random name includes the word “bilim”.

abcdefbilimghjk

5 לייקים

Hi Emre, thanks for the report, I’ve now fixed the issue with loose matching of slugs. If you update the theme, it should be resolved, “abcdefbilimghjk” will no longer apply the icon to the “bilim” slug.

8 לייקים

It’s been perfectly resolved. Thanks for the update :+1:

6 לייקים

This is an awesome component! Works great on my site! ty for doing this :smiley:!awe

6 לייקים

Can I use this icon as “js”?

image

Only bash has the icon, the others has an emty space.

image

What do I miss?

לייק 1

Have a look here to learn how to use new font awesome icons

4 לייקים

Thanks, but how that breaks down to using this component as a plugin user?

Should I wait for something to merge to master before I can use the plugin?

Or did I misunderstand the method to define how can I specify my font awesome icons?

לייק 1

Use fab-js instead of js in both fields since it’s a brand icon and FA groups brand icons separately.

Same for the Java icon, though you should be on tests-passed for that to work, because the Java icon was added to FontAwesome recently.

4 לייקים

Can this component be extended to support custom made svg icons?

2 לייקים

Custom SVG icons are already supported in plugins, see Introducing Font Awesome 5 and SVG icons for details. Custom SVG icon support in themes is in the works.

8 לייקים

Thank you for quick response. I will look into it.

לייק 1

First, a big thank you to @pmusaraj for making this great theme-component.

I have configured it on my site, but have two issues:

There seems to be no way I can “attach” any icon to Jadran category
I have tried with various icons, even the ones that are working on other categories with no success.

Configuration is the same as for other categories:

It seems that pull-downs in category view, does not respect the icon color (white).
Here it looks the worst - gray on gray.

Elsewhere, white color is respected:

לייק 1

I have an idea, why “Jadran” does not work: I have another category “Jadranje”, which includes first name. I would expect that slug would be checked with exact match (everything between /), right?

לייק 1

In the URL you posted https://pojalabanda.com/c/potovanja/jadran, I see the icon next to Jadran.

I do see the style issue, it’s something that’s been recently introduced, I’ll look for a solution.

4 לייקים

Yes, I got idea for workaround: have replaced the order of “rules” in the config, so that longer name is after shorter:
image

It works now!

Thanks for checking the problem and for confirming style issue.

3 לייקים

Is there a possibility to upload own svg icon and then use it as category icon? I tried to upload it on Category icons upload, but not sure how should I reference it?

Or am I completely on wrong track here?

2 לייקים

It’s slightly different, you need to upload an svg sprite. See this:

6 לייקים

I have pushed a fix for the style issue in core: UX: Inherit badge icon color · discourse/discourse@8d098df · GitHub

Once this passes tests, you need to rebuild your app, icon colors should then respect the badge color.

6 לייקים

Do you have any plans to extend this to the sub-category boxes Penar? Would be awesome to have them everywhere. My site looks great with all these icons now, appreciate this!

5 לייקים