# Displaying a directory of groups

URL: https://wpusermanager.com/article/250-displaying-a-directory-of-groups/
Last updated: 2026-10-07

Show a directory of your groups anywhere with the `[wpum_group_directory]` shortcode. It lists public and private groups; hidden groups are never listed.

Shortcode options
-----------------

- `per_page`: how many groups to show per page, with pagination for the rest. Default 10.
- `has_search_form`: show the search form and filters. Default `true`.
- `show_public`: include public groups. Default `true`.
- `show_private`: include private groups. Default `true`.

For example, a directory of private groups only, 20 per page:

```
[wpum_group_directory per_page="20" show_public="false"]

```

In the classic editor, the WPUM shortcode button has a **Group Directory** option that builds the shortcode for you.

![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82af8ccff47e001a58d409/file-mpEryXOKHG.png)

What visitors see
-----------------

- **Search** by group name, and **filter** by category and tag.
- Each group's privacy, number of members, and a **Join** or **Leave** button for logged-in users.
- Logged-in users also get **All Groups** and **My Groups** buttons with counts, to switch between every group and the ones they're in.
- Users who can create groups get a **Create a Group** link.

![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634115d694b44a06b9ce8/07-directory-7c750344.png)