# 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:** 20
**Page:** 2

<div class="post-metadata">

### Author: ![jrgong](https://avatars.discourse-cdn.com/v4/letter/j/c57346/32.png) [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [February 14, 2022, 9:55am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/29 "2022-02-14T09:55:16Z")

</div>

Hey @jordan.vidrine

thx for the feedback, I will keep that in mind for any PR coming your way 🙂

BTW on our forum the docs cards are not hidden when an actual docs topic is opened.

See example:  
[https://forum.cannabisanbauen.net/docs?topic=14469](https://forum.cannabisanbauen.net/docs?topic=14469)

We had same issue on 2.7.x. and after 2.8.1 update it still persists. Any idea what causes the issue?

---

<div class="post-metadata">

### Author: ![jordan.vidrine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordan.vidrine/32/515563_2.png) [@jordan.vidrine](https://meta.discourse.org/u/jordan.vidrine)
#### Post date: [February 14, 2022, 4:06pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/30 "2022-02-14T16:06:22Z")

</div>

This is because you are not sorting or filtering yet, you are only linking to an article being rendered in the docs view, without any filters yet. The cards only disappear once a card is clicked in order to set the current filter.

---

<div class="post-metadata">

### Author: ![jordan.vidrine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordan.vidrine/32/515563_2.png) [@jordan.vidrine](https://meta.discourse.org/u/jordan.vidrine)
#### Post date: [March 3, 2022, 5:02pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/31 "2022-03-03T17:02:26Z")

</div>

[https://github.com/discourse/discourse-docs-card-filter/pull/8](https://github.com/discourse/discourse-docs-card-filter/pull/8)

This latest PR which has been merged adds category & tag names as classes to their cards.

---

<div class="post-metadata">

### Author: ![jrgong](https://avatars.discourse-cdn.com/v4/letter/j/c57346/32.png) [@jrgong](https://meta.discourse.org/u/jrgong)
#### Post date: [March 7, 2022, 6:22pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/32 "2022-03-07T18:22:02Z")

</div>

When a tag or category starts with a digit, the css class becomes invalid. Can you make an adjustment, for example prepend `card-` to the class name to prevent the issue?

Currently: `<a class="docs-card-box tag-card [category]">`  
Fixed: `<a class="docs-card-box tag-card card-[category]">`

---

<div class="post-metadata">

### Author: ![thaidb](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thaidb/32/68488_2.png) [@thaidb](https://meta.discourse.org/u/thaidb)
#### Post date: [April 24, 2022, 6:05pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/33 "2022-04-24T18:05:42Z")

</div>

Hello, can we display all card later we click any card?  
Thank you!

---

<div class="post-metadata">

### Author: ![thaidb](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thaidb/32/68488_2.png) [@thaidb](https://meta.discourse.org/u/thaidb)
#### Post date: [July 9, 2022, 10:13am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/34 "2022-07-09T10:13:44Z")

</div>

Excuse me,  
Can we uppercase tag?  
Thank you!

 ![image](https://global.discourse-cdn.com/meta/original/4X/c/5/4/c546f2bfd8b512003555a415d1e473a8ad9d7b28.png)

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [July 9, 2022, 10:40am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/35 "2022-07-09T10:40:02Z")

</div>

There’s the `force lowercase tags` admin setting you could toggle that may help here:

 ![image](https://global.discourse-cdn.com/meta/original/4X/4/9/6/496bacee3dfc3aedcfe53f8ffbb9c51b9a228bbf.png)

---

<div class="post-metadata">

### Author: ![thaidb](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thaidb/32/68488_2.png) [@thaidb](https://meta.discourse.org/u/thaidb)
#### Post date: [July 9, 2022, 10:53am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/36 "2022-07-09T10:53:24Z")

</div>

Thank you Very much 🙂

---

<div class="post-metadata">

### Author: ![denvergeeks](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/denvergeeks/32/327671_2.png) [@denvergeeks](https://meta.discourse.org/u/denvergeeks)
#### Post date: [August 27, 2022, 4:20pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/37 "2022-08-27T16:20:48Z")

</div>

You can hide it using CSS…

```plaintext
@media screen and (max-width: 700px) {
.docs-cards-filter {
    display: none;
    }
}

```

---

<div class="post-metadata">

### Author: ![Discoursenaut](https://avatars.discourse-cdn.com/v4/letter/d/8baadc/32.png) [@Discoursenaut](https://meta.discourse.org/u/Discoursenaut)
#### Post date: [January 2, 2023, 6:37pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/38 "2023-01-02T18:37:46Z")

</div>

Is there anyway to change ‘docs’ to something else, like ‘Community Guides’, it would be great to be able to easily customize this from admin or theme settings.

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [January 2, 2023, 6:40pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/39 "2023-01-02T18:40:46Z")

</div>

`Admin - Customize - Text` and search for docs. You can change (almost) everything there.

---

<div class="post-metadata">

### Author: ![Discoursenaut](https://avatars.discourse-cdn.com/v4/letter/d/8baadc/32.png) [@Discoursenaut](https://meta.discourse.org/u/Discoursenaut)
#### Post date: [January 3, 2023, 11:23am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/40 "2023-01-03T11:23:19Z")

</div>

What is the syntax to get multiple tag icons to show up? I can successfully display one icon, but then is it just a comma to separate entries?

---

<div class="post-metadata">

### Author: ![Ayelen\_Rives](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ayelen_rives/32/226978_2.png) [@Ayelen\_Rives](https://meta.discourse.org/u/Ayelen_Rives)
#### Post date: [March 6, 2023, 4:18pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/41 "2023-03-06T16:18:18Z")

</div>

Hi!  
Maybe I’m missing something but… is it possible to add this theme component without installing the Docs plugin?  
My site is already a knowledge base, so I don’t see what the plugin can add to it that doesn’t bring confusion or duplicated accesses, and I’d prefer not installing it. But… I really need some boxes/ cards on top to guide users through categories and tags. That is why I find extremely useful this component but can’t decide on the plugin.

Can anyone help me to sort it out?  
Thanks a lot!

---

<div class="post-metadata">

### Author: ![jordan.vidrine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordan.vidrine/32/515563_2.png) [@jordan.vidrine](https://meta.discourse.org/u/jordan.vidrine)
#### Post date: [March 6, 2023, 4:23pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/42 "2023-03-06T16:23:10Z")

</div>

This component is an add-on to the docs plugin. To get category boxes, you may be interested in some of these components:

> [@Custom Category Boxes](https://meta.discourse.org/t/custom-category-boxes/144865):
>
> discourse2Summary Custom Category Boxes will render your categories as boxes with customized backgrounds on your categories page. This component will also render each category page with a category banner if show\_banner is selected.eyeglassesPreview [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/custom-category-boxes)hammer_and_wrenchRepository Link [https://github.com/discourse/discourse-custom-category-boxes-component](https://github.com/discourse/discourse-custom-category-boxes-component)open_bookNew to Discourse Themes? [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) I…

> [@Category Groups](https://meta.discourse.org/t/category-groups/200874):
>
> discourse2Summary Category Groups allows you to assign categories to groups, which are then used to sort and collapse categories on the categories page.eyeglassesPreview [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/category-groups)hammer_and_wrenchRepository Link [https://github.com/discourse/discourse-category-groups-component](https://github.com/discourse/discourse-category-groups-component)open_bookNew 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 Featuresinformation_source Important things to n…

---

<div class="post-metadata">

### Author: ![Ayelen\_Rives](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ayelen_rives/32/226978_2.png) [@Ayelen\_Rives](https://meta.discourse.org/u/Ayelen_Rives)
#### Post date: [March 6, 2023, 4:35pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/43 "2023-03-06T16:35:44Z")

</div>

Thank you Jordan! 🙌  
I’ll try this components, surely will solve the issue!

---

<div class="post-metadata">

### Author: ![scharnkn](https://avatars.discourse-cdn.com/v4/letter/s/45deac/32.png) [@scharnkn](https://meta.discourse.org/u/scharnkn)
#### Post date: [April 19, 2023, 10:23am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/44 "2023-04-19T10:23:23Z")

</div>

This looks great!

Just one question, is this theme component still maintained? I’m just asking because the last commit is from more than a year ago.

---

<div class="post-metadata">

### Author: ![satonotdead](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/satonotdead/32/447830_2.png) [@satonotdead](https://meta.discourse.org/u/satonotdead)
#### Post date: [April 30, 2023, 2:00pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/45 "2023-04-30T14:00:02Z")

</div>

There was no commits but it stills working!

---

<div class="post-metadata">

### Author: ![thaidb](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thaidb/32/68488_2.png) [@thaidb](https://meta.discourse.org/u/thaidb)
#### Post date: [September 12, 2023, 9:44am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/48 "2023-09-12T09:44:48Z")

</div>

I find that this component not display category parent if this category don’t have separate topics.

Specifically, the “Cần thuê” is Category parent that it isn’t display in Docs Filter UI.  
How can we display this category and display count topics equal all of topic of child categories!  
Thank you so much!

 ![image](https://global.discourse-cdn.com/meta/original/4X/e/2/c/e2cb4b5b2a33606e0519b973214b847ae658791f.png)

Mean…  
Parent-category (10 topics) have 10 child-category, each child-category have 10 topics  
I wanna card parent-category display count is 110 Topics not 10 Topics  
Best regard

---

<div class="post-metadata">

### Author: ![thaidb](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/thaidb/32/68488_2.png) [@thaidb](https://meta.discourse.org/u/thaidb)
#### Post date: [September 12, 2023, 9:52am UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/49 "2023-09-12T09:52:43Z")

</div>

![image](https://global.discourse-cdn.com/meta/original/4X/8/7/1/8714a766f2c41c79ce9abb503a8ba718fe90da7c.png)  
 ![image](https://global.discourse-cdn.com/meta/original/4X/2/4/f/24f1cf1a49c77da39d36013a0740283e190334da.png)

Can we use show tags by group in homepage?  
Thank you!

---

<div class="post-metadata">

### Author: ![jordan.vidrine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jordan.vidrine/32/515563_2.png) [@jordan.vidrine](https://meta.discourse.org/u/jordan.vidrine)
#### Post date: [September 12, 2023, 1:53pm UTC](https://meta.discourse.org/t/discourse-docs-card-filter/187947/50 "2023-09-12T13:53:59Z")

</div>

I understand your reasoning behind this, but we do not technically count these topics as apart of the parent category even in Core behind the scenes, so we wouldnt want to do so differently in this component.

[Previous page](https://meta.discourse.org/t/discourse-docs-card-filter/187947.md?page=1)

[Next page](https://meta.discourse.org/t/discourse-docs-card-filter/187947.md?page=3)
