# User Card Directory
**URL:** https://meta.discourse.org/t/user-card-directory/144479
**Category:** Theme component
**Tags:** official, user-card-directory
**Created:** [March 16, 2020, 2:21pm UTC](https://meta.discourse.org/t/user-card-directory/144479 "2020-03-16T14:21:04Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [March 16, 2020, 2:21pm UTC](https://meta.discourse.org/t/user-card-directory/144479/1 "2020-03-16T14:21:04Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **User Card Directory** changes the `/u` user directory to display a grid of user cards instead of the stats table. |
| š | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/user-card-directory) |
| š | **Repository Link** | [https://github.com/discourse/discourse-user-card-directory](https://github.com/discourse/discourse-user-card-directory) |
| š | **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=user-card-directory "Ask for support on configuring and using User Card Directory") [š **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=user-card-directory "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=user-card-directory "Discussion about the user interface of User Card Directory, and how features are presented (including language and UI elements)") [š” **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=user-card-directory "Discussion about how existing User Card Directory features can be improved or enhanced, and how proposed new features could work")
### Features
### Settings
| Name | Description |
| --- | --- |
| hide current user | Always hide the current user from the grid |
| show stats | Show statistics under each user card |
| default view | |
| Translation | Default |
| --- | --- |
| show\_cards | Show as cards |
| show\_table | Show as table |
### Credits
Big thanks to @joebuhlig for [discourse-biobook](https://procourse.co/portfolio/discourse-biobook/), which inspired this work. And also @angus @fzngagan and @alxpck for prompting the various core improvements we needed to make this achievable.
> :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans.
> Last edited by @JammyDodger 2024-06-13T05:15:39Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@fzngagan](https://meta.discourse.org/u/fzngagan)
#### Post date: [March 16, 2020, 2:23pm UTC](https://meta.discourse.org/t/user-card-directory/144479/2 "2020-03-16T14:23:15Z")
Great. Very delighted to see this one launched.
---
### Author:  [@Bank\_Live](https://meta.discourse.org/u/Bank_Live)
#### Post date: [March 16, 2020, 2:25pm UTC](https://meta.discourse.org/t/user-card-directory/144479/3 "2020-03-16T14:25:31Z")
I love it. Thank you.
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [March 16, 2020, 9:06pm UTC](https://meta.discourse.org/t/user-card-directory/144479/4 "2020-03-16T21:06:00Z")
Nice! The only weirdness Iām seeing is the website is showing twice on my site [Nature Photographers Network](https://community.naturephotographers.network/u)
---
### Author:  [@omarfilip](https://meta.discourse.org/u/omarfilip)
#### Post date: [March 16, 2020, 9:26pm UTC](https://meta.discourse.org/t/user-card-directory/144479/5 "2020-03-16T21:26:19Z")
Excellent component!
Perhaps similar to the duplication that David mentioned, the location is shown twice when the Discourse Locations plugin is used.
The first line in the screenshot above is from the Discourse profile location. The second is from the Locations plugin.
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [March 17, 2020, 12:07am UTC](https://meta.discourse.org/t/user-card-directory/144479/6 "2020-03-17T00:07:11Z")
Thanks @omarfilip and @davidkingham. Looks to be a slight incompatibility with the locations plugin. [Should be resolved now](https://meta.discourse.org/t/locations-plugin/69742/468)
BTW @davidkingham your `/u` page is blank for anonymous visitorsā¦ not sure exactly why - but I guess it is one of your plugins and/or themes.
---
### Author:  [@cjk77](https://meta.discourse.org/u/cjk77)
#### Post date: [March 17, 2020, 1:51pm UTC](https://meta.discourse.org/t/user-card-directory/144479/7 "2020-03-17T13:51:49Z")
This component doesnāt seem to work properly on the latest stable release ā¦ I donāt see any of the details on the user cards:
(Thatās the Vincent theme shown, but I also tested it on plain vanilla Discourse with the same results.)
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [March 17, 2020, 1:54pm UTC](https://meta.discourse.org/t/user-card-directory/144479/8 "2020-03-17T13:54:11Z")
Yes, unfortunately itās only compatible with the latest tests-passed version of discourse
> [@david](#):
>
> The required APIs were [added](https://github.com/discourse/discourse/commit/ff62911a89d721ebec1716990c5e407e572d8960) to tests-passed on 6th March 2020, so make sure you have updated Discourse since then
---
### Author:  [@cjk77](https://meta.discourse.org/u/cjk77)
#### Post date: [March 17, 2020, 1:55pm UTC](https://meta.discourse.org/t/user-card-directory/144479/9 "2020-03-17T13:55:28Z")
Ah, ok! Thanks for the clarification! (I missed the note about it in the OP š¤¦āāļø )
---
### Author:  [@weallwegot](https://meta.discourse.org/u/weallwegot)
#### Post date: [March 21, 2020, 7:33pm UTC](https://meta.discourse.org/t/user-card-directory/144479/10 "2020-03-21T19:33:21Z")
Thanks this is beautiful and something Iāve been thinking about for a while. I know this is a theme component so not sure it changes any functionality, but asking anyways. Does this happen to enable users to search each other by their attributes?
For instance if a custom attribute for users is `University Attended` and a user wanted to find everyone who went to a particular school could they search for `Stanford` and have all the users pull up here? I saw this [link](https://meta.discourse.org/t/changes-to-the-user-card-data-source/139951) that seemed to maybe imply that but having trouble interpreting it.
might be out of the scope, but i found this post linked on another one that seemed to be headed down that route.
Thanks & awesome work!
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [March 22, 2020, 10:35am UTC](https://meta.discourse.org/t/user-card-directory/144479/11 "2020-03-22T10:35:25Z")
Hi @weallwegot,
Unfortunately not, this doesnāt add the ability to filter users by their metadata. It does add a group dropdown, so maybe that could work for you? You could have groups for each university, people could join those groups, and then they would appear in the dropdown
---
### Author:  [@Heliosurge](https://meta.discourse.org/u/Heliosurge)
#### Post date: [March 25, 2020, 11:00pm UTC](https://meta.discourse.org/t/user-card-directory/144479/12 "2020-03-25T23:00:37Z")
Awesome Theme Component - Though will need to wait for Discourse 2.5 roll out.
---
### Author:  [@aksoforever](https://meta.discourse.org/u/aksoforever)
#### Post date: [March 27, 2020, 5:33am UTC](https://meta.discourse.org/t/user-card-directory/144479/13 "2020-03-27T05:33:48Z")
Hi, David
i have a confusion, when i use search or select a group, my personal user card always shows, whether i am in the group or not in.
can you help me,
how to remove my card if iām not in the select group or iām not the search name.
---
### Author:  [@weallwegot](https://meta.discourse.org/u/weallwegot)
#### Post date: [April 4, 2020, 10:53pm UTC](https://meta.discourse.org/t/user-card-directory/144479/14 "2020-04-04T22:53:01Z")
Ah okay. I see. I meant [this link](https://meta.discourse.org/t/user-card-directory/144479/10) and @fzngaganās [PR](https://github.com/discourse/discourse/pull/8376), but i see it was declined.
The only thing with the groups approach you mentioned is I think it would put a lot of manual onus on the moderators/admin of the forum to put people in groups as they join or worse, as they update their profile.
Iām trying to think of a workaround. Perhaps if there was a way to automate the segmentation of users into groups by a custom attribute, dropdown though so its exact matches? Curious if you know of anything like that.
Iāll look around.
---
### Author:  [@Pad\_Pors](https://meta.discourse.org/u/Pad_Pors)
#### Post date: [April 5, 2020, 9:01am UTC](https://meta.discourse.org/t/user-card-directory/144479/15 "2020-04-05T09:01:19Z")
nice presentation, itād be great if one could switch between different displays: grid and table.
also the āfilter by groupā string can not be translated. may you fix it?
---
### Author:  [@fzngagan](https://meta.discourse.org/u/fzngagan)
#### Post date: [April 5, 2020, 11:19am UTC](https://meta.discourse.org/t/user-card-directory/144479/16 "2020-04-05T11:19:11Z")
@david
I setup your component on my local setup and results are amazing. Appreciate the efforts.
I noticed thereās a hidden site setting `enable_new_user_card_route` but it doesnāt seem to change the results here. Is the setting required for anything here?
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [April 5, 2020, 11:30am UTC](https://meta.discourse.org/t/user-card-directory/144479/17 "2020-04-05T11:30:52Z")
Nope, that setting is not required for this. It changes the route used for ānormalā user cards, so that theyāre much more efficient. Weāll be changing the default to true in the next few weeks.
Iāll update in this topic when itās done: [Changes to the user card data source](https://meta.discourse.org/t/changes-to-the-user-card-data-source/139951)
---
### Author:  [@Lynne\_Fetterman1](https://meta.discourse.org/u/Lynne_Fetterman1)
#### Post date: [April 15, 2020, 4:57am UTC](https://meta.discourse.org/t/user-card-directory/144479/18 "2020-04-15T04:57:15Z")
> [@david](#):
>
> Yes, unfortunately itās only compatible with the latest tests-passed version of discourse
>
> > [@david](#):
> >
> > The required APIs were [added](https://github.com/discourse/discourse/commit/ff62911a89d721ebec1716990c5e407e572d8960) to tests-passed on 6th March 2020, so make sure you have updated Discourse since then
We are running the master, which says it is even with tests-passed, but I am still having the problem with missing details on the cards, just as on the screenshot @cjk77 posted. Do we need to switch to tests-passed to get this working?
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [April 15, 2020, 8:12am UTC](https://meta.discourse.org/t/user-card-directory/144479/19 "2020-04-15T08:12:39Z")
You shouldnāt run `master` in production - it sometimes contains commits which have not yet passed continuous integration tests. `tests-passed` is much safer, and only a few minutes behind.
But yes, this theme should work on master. Can you share a link to your site so I can take a look?
---
### Author:  [@Lynne\_Fetterman1](https://meta.discourse.org/u/Lynne_Fetterman1)
#### Post date: [April 16, 2020, 4:56pm UTC](https://meta.discourse.org/t/user-card-directory/144479/20 "2020-04-16T16:56:54Z")
Thanks David. Our site is at connect.arival,travel.
[Next page](https://meta.discourse.org/t/user-card-directory/144479.md?page=2)