# rpk group list

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

---
title: rpk group list
latest-operator-version: v26.2.1
latest-console-tag: v3.10.0
latest-connect-version: 4.104.0
latest-redpanda-tag: v26.2.1
docname: rpk/rpk-group/rpk-group-list
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: rpk/rpk-group/rpk-group-list.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/reference/pages/rpk/rpk-group/rpk-group-list.adoc
description: List all groups. This command lists all groups currently known to Redpanda, including empty groups that have not yet expired.
page-git-created-date: "2024-07-25"
page-git-modified-date: "2026-08-11"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/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 columns shows which state the group is in:

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

-   `CompletingRebalance`: The group is waiting on 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
rpk group ls
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --format | string | Output format (json,yaml,text,wide,help). (New in v26.2.1) |
| -s, --states | stringSlice | Comma-separated list of group states to filter for. Possible states: [PreparingRebalance, CompletingRebalance, Stable, Dead, Empty]. |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |