---
title: rpk cluster partitions list
latest-redpanda-tag: v24.3.9
latest-console-tag: v3.14.0
latest-operator-version: v2.3.8-24.3.6
# 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.118.0
docname: rpk/rpk-cluster/rpk-cluster-partitions-list
page-component-name: streaming
page-version: "24.3"
page-component-version: "24.3"
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.3/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"
page-generated-content: none
support-status: past end-of-life
---

# 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)

<!-- Source: https://docs.redpanda.com/streaming/24.3/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.

## 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

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

## Aliases

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

## 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`](https://docs.redpanda.com/streaming/24.3/reference/rpk/rpk-x-options/) or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail. |
| `--profile` | string | Profile to use. See [`rpk profile`](https://docs.redpanda.com/streaming/24.3/reference/rpk/rpk-profile/rpk-profile/) for more details. |
| `-v, --verbose` | - | Enable verbose logging. |

## 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
```