# 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-redpanda-tag: v26.1.14
latest-console-tag: v3.9.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: March 31, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-cluster/rpk-cluster-partitions-list
page-component-name: streaming
page-version: "26.1"
page-component-version: "26.1"
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/26.1/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-partitions-list.adoc
description: List partitions in the cluster. This command lists the cluster-level metadata of all partitions, including current replica assignments on brokers and CPU cores for given topics.
page-git-created-date: "2023-12-22"
page-git-modified-date: "2026-07-17"
support-status: supported
---

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

List partitions in the cluster. This command lists the cluster-level metadata of all partitions, including current replica assignments on brokers and CPU cores for given topics.

## [](#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 partitions using `rpk cluster partitions enable/disable`.

## [](#usage)Usage

```bash
rpk cluster partitions list <topics...> [flags]
```

## [](#aliases)Aliases

```bash
rpk cluster partitions ls
rpk cluster partitions describe
```

## [](#examples)Examples

This section provides examples of how to use `rpk cluster partitions list`.

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 partitions list -a --format json
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -a, --all | bool | List all partitions in the cluster. |
| --disabled-only | bool | List disabled partitions only. |
| --format | string | Output format (json,yaml,text,wide,help). |
| -n, --node-ids | intSlice | List of comma-separated broker IDs that you wish to filter the results with. |
| -p, --partition | intSlice | List of comma-separated partitions IDs that you wish to filter the results with. |

## [](#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. |