# Discourse Docs Card Filter **URL:** https://meta.discourse.org/t/discourse-docs-card-filter/187947 **Category:** Theme component **Tags:** official, docs, docs-card-filter **Created:** [April 23, 2021, 9:13pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947 "2021-04-23T21:13:37Z") **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: [April 23, 2021, 9:13pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/1 "2021-04-23T21:13:37Z")
| | | | | --- | --- | --- | | :discourse2: | **Summary** | **Discourse Docs Card Filter** is to be used with the [Discourse Docs Plugin](https://github.com/discourse/discourse-docs) and allows you to place “Cards” that act as a clickable filter for quicker filter results upon entering the `/docs` page by your users. | | 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/docs-card-filter) | | 🛠 | **Repository Link** | [https://github.com/discourse/discourse-docs-card-filter](https://github.com/discourse/discourse-docs-card-filter) | | 📖 | **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=docs-card-filter "Ask for support on configuring and using Docs Card Filter") [🐛  **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=docs-card-filter "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=docs-card-filter "Discussion about the user interface of Docs Card Filter, and how features are presented (including language and UI elements)") [💡  **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=docs-card-filter "Discussion about how existing Docs Card Filter features can be improved or enhanced, and how proposed new features could work") ### Features ![image](https://global.discourse-cdn.com/meta/original/3X/3/8/3832c36244e7ee55afebd4abab8aa553ae1825fc.png) The above would be rendered with these settings in the `docs` plugin: ![image](https://global.discourse-cdn.com/meta/original/3X/2/c/2c36bdce6dcae117fcfd0c1dc73981c65af45965.png) ### Settings You can select custom icons for each category or tag card filter. You can also allow category descriptions to be rendered in the category card filters. | Name | Description | | --- | --- | | category icons | Choose icons & topics order for corresponding category IDs. ex. ‘6,heart,title-asc’ would assign the heart icon to category 6 & will order topic list by ascending activity. NOTE: order can be (title,activity)-(asc/desc) | | category description | Enable the category description to be displayed in the category card filters for the docs page. | | tag icons | Choose icons & topics order for corresponding tag slugs. ex. ‘featured,heart,activity-desc’ would assign the heart icon to featured tag & will order topic list by ascending activity. NOTE: order can be (title,activity)-(asc/desc) | | Translation | Default | | --- | --- | | topics | Topics | | topic | Topic | > :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans. > Last edited by @JammyDodger 2024-06-12T08:47:57Z > > > **Check document** > > > > Perform check on document: --- _[View the full topic](https://meta.discourse.org/t/discourse-docs-card-filter/187947)._