# rpk shadow status

> 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 status
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-status
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-status.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/reference/pages/rpk/rpk-shadow/rpk-shadow-status.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-status.md -->

Shows the status of a Redpanda shadow link.

This command shows the current status of a shadow link, including the overall state, task statuses, and per-topic replication progress. Use this command to monitor replication health and track how closely shadow topics follow the source cluster.

By default, the command displays all status sections. Use the `--print-*` flags to select specific sections (overview, task status, or topic status). The `--format json|yaml` flag changes only the output format, not which sections are included.

## [](#usage)Usage

```bash
rpk shadow status [LINK_NAME] [flags]
```

## [](#examples)Examples

Display the status of a shadow link:

```bash
rpk shadow status my-shadow-link
```

Display specific sections:

```bash
rpk shadow status my-shadow-link --print-overview --print-topic
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -a, --print-all | - | Print all sections. |
| --format | string | Output format. Possible values: json, yaml, text, wide, help. Default: text. |
| -o, --print-overview | - | Print the overview section. |
| -k, --print-task | - | Print the task status section. |
| -t, --print-topic | - | Print the detailed topic status section. |
| -h, --help | - | Help for status. |
| --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. |