# rpk shadow 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 shadow list
latest-redpanda-tag: v25.3.11
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: "false"
page-eol-date: November 19, 2026
latest-connect-version: 4.93.0
docname: rpk/rpk-shadow/rpk-shadow-list
page-component-name: streaming
page-version: "25.3"
page-component-version: "25.3"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-shadow/rpk-shadow-list.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/25.3/modules/reference/pages/rpk/rpk-shadow/rpk-shadow-list.adoc
page-git-created-date: "2025-11-19"
page-git-modified-date: "2025-12-12"
support-status: supported
---

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

Lists Redpanda shadow links.

This command lists all shadow links on the shadow cluster, showing their names, unique identifiers, and current states. Use this command to get an overview of all configured shadow links and their operational status.

## [](#usage)Usage

```bash
rpk shadow list [flags]
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --format | string | Output format. Possible values: json, yaml, text, wide, help. Default: text. |
| -h, --help | - | Help for list. |
| --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. |