# rpk shadow 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 shadow list
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: rpk/rpk-shadow/rpk-shadow-list
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: rpk/rpk-shadow/rpk-shadow-list.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/reference/pages/rpk/rpk-shadow/rpk-shadow-list.adoc
page-git-created-date: "2025-12-12"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/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. |