# Category Groups

**URL:** https://meta.discourse.org/t/category-groups/200874
**Category:** Theme component
**Tags:** official, category-groups
**Created:** [August 18, 2021, 6:35pm UTC](https://meta.discourse.org/t/category-groups/200874 "2021-08-18T18:35:21Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### 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: [August 18, 2021, 6:35pm UTC](https://meta.discourse.org/t/category-groups/200874/1 "2021-08-18T18:35:21Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Category Groups** allows you to assign categories to groups, which are then used to sort and collapse categories on the categories page. |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/category-groups) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-category-groups-component](https://github.com/discourse/discourse-category-groups-component) |
| 📖 | **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. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=category-groups "Ask for support on configuring and using Category Groups") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=category-groups "A bug report means something is broken, preventing normal/typical use of the theme component") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=category-groups "Discussion about the user interface of Category Groups, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=category-groups "Discussion about how existing Category Groups features can be improved or enhanced, and how proposed new features could work")

### Features

> ℹ Important things to note:
> 
> - This theme component only works with the site setting `desktop category page style` set to `boxes with subcategories` (as it replaces that category page template).
> 
> - The category collapsing works using your browser’s local storage, so the collapsed state will not be remembered between different devices.

 ![category groups example](https://global.discourse-cdn.com/meta/original/3X/a/7/a75ad62a3613b128350602a7ffdf2aa6d97199fd.png)

 ![0a58432c737f278c393649e1570a7a5266a45340_2_775x414](https://global.discourse-cdn.com/meta/original/4X/2/e/6/2e6b02e57b3630ed0edc5b525fed12157b0c4336.png)

### Settings

| Name | Description |
| --- | --- |
| category groups | This is how the groups are configured. Format as: Group name: category-slug, extra-link-id, category-slug-2 (The category slug is the name of the category as it’s seen in URLs. Usually all lowercase with no spaces) |
| extra links | Extra links that can be mixed into category list. Add link ID in category\_groups setting to render |
| show on mobile | Show the collapsible category box groups on mobile |
| show ungrouped | Display a group of categories that aren’t assigned to another group |
| fancy styling | Turn on additional styling (These are some custom styles added. They stray from our defaults, so if you’re working on your own theme you may want to disable this) |
| hide muted subcategories | When enabled, a non-muted parent category will not appear under the muted section if it has a muted subcategory |

| Theme Translations | Default |
| --- | --- |
| ungrouped\_categories\_title | Other |

  

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

> Last edited by @tobiaseigen 2025-06-24T03:16:42Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/category-groups/200874)._