# rpk group list

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk group list
latest-redpanda-tag: v24.3.9
latest-console-tag: v3.7.3
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "true"
page-eol-date: December 3, 2025
latest-connect-version: 4.93.0
docname: rpk/rpk-group/rpk-group-list
page-component-name: streaming
page-version: "24.3"
page-component-version: "24.3"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-group/rpk-group-list.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/24.3/modules/reference/pages/rpk/rpk-group/rpk-group-list.adoc
page-git-created-date: "2023-05-17"
page-git-modified-date: "2024-08-01"
support-status: past end-of-life
---

<!-- Source: https://docs.redpanda.com/streaming/24.3/reference/rpk/rpk-group/rpk-group-list.md -->

List all groups.

This command lists all groups currently known to Redpanda, including empty groups that have not yet expired. The BROKER column is which broker node is the coordinator for the group. This command can be used to track down unknown groups, or to list groups that need to be cleaned up.

The STATE column shows which state the group is in:

-   `PreparingRebalance`: The group is preparing to rebalance.

-   `CompletingRebalance`: The group is waiting for the leader to provide assignments.

-   `Stable`: The group is not empty and has no group membership changes in process.

-   `Dead`: Transient state as the group is being removed.

-   `Empty`: The group currently has no members.


## [](#usage)Usage

```bash
rpk group list [flags]
```

## [](#aliases)Aliases

```bash
list, ls
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -h, --help | - | Help for list. |
| -s, --states | strings | Comma-separated list of group states to filter for. Possible states: [PreparingRebalance, CompletingRebalance, Stable, Dead, Empty]. |
| --config | string | Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail. |
| --profile | string | Profile to use. See rpk profile for more details. |
| -v, --verbose | - | Enable verbose logging. |