# Category Icons **URL:** https://meta.discourse.org/t/category-icons/104683 **Category:** Theme component **Tags:** official, deprecated, category-icons **Created:** [December 19, 2018, 4:22pm UTC](https://meta.discourse.org/t/category-icons/104683 "2018-12-19T16:22:44Z") **Posts on this page:** 1 **Showing post:** 1
### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse) #### Post date: [December 19, 2018, 4:22pm UTC](https://meta.discourse.org/t/category-icons/104683/1 "2018-12-19T16:22:44Z")
> ⚠ > This theme component is deprecated and should no longer be used. Its features are now in Discourse Core (see: [Bringing popular features to Discourse](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169)). > For private category icon customization, refer to [this topic](https://meta.discourse.org/t/new-aliases-for-replacing-lock-icons-on-closed-topics-and-restricted-categories/373778). | | | | | --- | --- | --- | | :discourse2: | **Summary** | **Category Icons** allows category badge links to have icons next to the category name. | | 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/category-icons) | | 🛠 | **Repository Link** | [https://github.com/discourse/discourse-category-icons](https://github.com/discourse/discourse-category-icons) | | 📖 | **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=category-icons "Ask for support on configuring and using Category Icons") [🐛  **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=category-icons "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=category-icons "Discussion about the user interface of Category Icons, and how features are presented (including language and UI elements)") [💡  **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=category-icons "Discussion about how existing Category Icons features can be improved or enhanced, and how proposed new features could work") ### Features > ℹ This theme component is used alongside the [Category Badge Styles](https://meta.discourse.org/t/category-badge-styles/285320) theme component Here is an example of how this would look, with `category badge style` set to `none`: ![category_badge_style - none](https://global.discourse-cdn.com/meta/original/3X/8/a/8a65a4ab132f9f261c0598ef19f4888893914f76.png) Here is how this would look with `category badge style` set to `box`: ![category_badge_style - box](https://global.discourse-cdn.com/meta/original/3X/0/8/08ccf7985ed5a104ce2e8ee56f7cad8abc963e1b.png) Configuration is pretty straightforward: ![settings example](https://global.discourse-cdn.com/meta/original/3X/f/d/fd2cbfc992c1e54ce5a339f2b56e0f557755a38d.png) Note that this component also lets you override the `category lock icon` used to denote private categories. > ℹ See also the [Tag Icons](https://meta.discourse.org/t/tag-icons-component/109757) 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”). 🏆 👏 > :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 document** > > > > Perform check on document: --- _[View the full topic](https://meta.discourse.org/t/category-icons/104683)._