# rpk shadow failover

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

Failover a Redpanda shadow link.

Failover converts shadow topics into regular topics on the shadow cluster, allowing producers and consumers to interact with them directly. After failover, the shadow link stops replicating data from the source cluster.

Use the `--all` flag to failover all shadow topics associated with the shadow link, or use the `--topic` flag to failover a specific topic. You must specify either `--all` or `--topic`.

The command prompts you to confirm the failover operation. Use the `--no-confirm` flag to skip the confirmation prompt.

> ⚠️ **WARNING**
>
> Failover is a critical operation. After failover, shadow topics become regular topics and replication stops. Ensure your applications are ready to connect to the shadow cluster before performing a failover.

## [](#usage)Usage

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

## [](#examples)Examples

Failover all topics for a shadow link:

```bash
rpk shadow failover my-shadow-link --all
```

Failover a specific topic:

```bash
rpk shadow failover my-shadow-link --topic my-topic
```

Failover without confirmation:

```bash
rpk shadow failover my-shadow-link --all --no-confirm
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --all | - | Failover all shadow topics associated with the shadow link. |
| --no-confirm | - | Disable confirmation prompt. |
| --topic | string | Specific topic to failover. If --all is not set, at least one topic must be provided. |
| -h, --help | - | Help for failover. |
| --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. |