# Categories Tracking Toggle

**URL:** <https://meta.discourse.org/t/categories-tracking-toggle/207150>\
**Category:** Theme component\
**Tags:** official, categories-tracking\
**Created:** [October 26, 2021, 5:12pm UTC](https://meta.discourse.org/t/categories-tracking-toggle/207150 "2021-10-26T17:12:58Z")\
**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/580155_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)\
**Post date:** [October 26, 2021, 5:12pm UTC](https://meta.discourse.org/t/categories-tracking-toggle/207150/1 "2021-10-26T17:12:58Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Categories Tracking Toggle** places a toggle button on each category on the categories page. |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-categories-tracking-toggle](https://github.com/discourse/discourse-categories-tracking-toggle) |
| 📖 | **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=categories-tracking "Ask for support on configuring and using Categories Tracking Toggle") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=categories-tracking "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=categories-tracking "Discussion about the user interface of Categories Tracking Toggle, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=categories-tracking "Discussion about how existing Categories Tracking Toggle features can be improved or enhanced, and how proposed new features could work")

> ℹ Note that it does not work on the “box” style category pages, which do not yet support a section for muted categories.

### Features

**Categories Tracking Toggle** places a toggle button on each category on the categories page, which allows users to quickly toggle between “mute” and “normal” tracking states. It is particularly useful for sites that use the `mute all categories by default` site setting.

 ![category tracking toggle example](https://global.discourse-cdn.com/meta/original/3X/e/0/e03850067f32339f883d29b9b4a439a1589f9fc2.png)

### Settings

The component comes with settings to change the tracking levels used, the icons, subcategory behavior, and text shown on hover.

| Name | Description |
| --- | --- |
| tracking level | 0: Muted, 1: Normal, 3: Watching first post, 4: Tracking, 5: Watching |
| tracking icon | [FontAwesome](https://fontawesome.com/v5.15/icons?d=gallery&m=free) icon name… |
| mute level | 0: Muted, 1: Normal, 3: Watching first post, 4: Tracking, 5: Watching |
| mute icon | |
| include subcategories | When disabled, only the parent category will have its tracking state changed |

| Theme Translation | Default |
| --- | --- |
| custom\_toggle.toggle\_tracking | Currently muted, select to track |
| custom\_toggle.toggle\_mute | Currently tracking, select to mute |

  

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

> Last edited by @JammyDodger 2024-06-11T08:49:03Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/categories-tracking-toggle/207150)._