# rpk cluster partitions 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 cluster partitions list
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: July 31, 2025
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
docname: rpk/rpk-cluster/rpk-cluster-partitions-list
page-component-name: streaming
page-version: "24.2"
page-component-version: "24.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-partitions-list.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/24.2/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-partitions-list.adoc
page-git-created-date: "2023-12-22"
page-git-modified-date: "2024-08-01"
support-status: past end-of-life
---

<!-- Source: https://docs.redpanda.com/streaming/24.2/reference/rpk/rpk-cluster/rpk-cluster-partitions-list.md -->

List partitions in the cluster.

This commands lists the cluster-level metadata of all partitions in the cluster.

It shows the current replica assignments on both brokers and CPU cores for given topics. By default, it assumes the `kafka` namespace, but you can specify an internal namespace using the `<namespace>/` prefix.

The `Replica-Core` column displayed in the output table contains a list of replica assignments in the form of <node-id>-<core>.

If the Disabled column contains a '-' value, then it means you are running this command against a cluster that does not support the underlying API.

## [](#enableddisabled)Enabled/Disabled

Disabling a partition in Redpanda involves prohibiting any data consumption or production to and from it. All internal processes associated with the partition are stopped, and it remains unloaded during system startup. This measure aims to maintain cluster health by preventing issues caused by specific corrupted partitions that may lead to Redpanda crashes. Although the data remains stored on disk, Redpanda ceases interaction with the disabled partitions to ensure system stability. You may disable/enable partition using `rpk cluster partitions enable/disable`.

## [](#usage)Usage

```bash
rpk cluster partitions list [TOPICS...] [flags]
```

## [](#aliases)Aliases

```bash
list, ls, describe
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -a, --all | - | If true, list all partitions in the cluster. |
| --disabled-only | - | If true, list disabled partitions only. |
| --format | string | Output format. Possible values: json, yaml, text, wide, help. Default: text. |
| -h, --help | - | Help for list. |
| -n, --node-ids | ints | List of comma-separated broker IDs you wish to use to filter the results. |
| -p, --partition | ints | List of comma-separated partitions IDs you wish to use to filter the results. |
| --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. |

## [](#examples)Examples

List all partitions in the cluster:

```bash
rpk cluster partitions list --all
```

List all partitions in the cluster, filtering for topic foo and bar:

```bash
rpk cluster partitions list foo bar
```

List partitions with replicas that are assigned to brokers 1 and 2.

```bash
rpk cluster partitions list foo --node-ids 1,2
```

List only the disabled partitions:

```bash
rpk cluster partitions list -a --disabled-only
```

List all in JSON format:

```bash
rpk cluster partition list -a --format json
```