# rpk shadow update

> 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 update
latest-redpanda-tag: v26.2.1
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: July 28, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-shadow/rpk-shadow-update
page-component-name: streaming
page-version: "26.2"
page-component-version: "26.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-shadow/rpk-shadow-update.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-shadow/rpk-shadow-update.adoc
description: Update a Shadow Link. This command opens your default editor with the current Shadow Link configuration.
page-git-created-date: "2025-11-19"
page-git-modified-date: "2026-08-01"
support-status: supported
---

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

Update a Shadow Link.

This command opens your default editor with the current Shadow Link configuration. Update the fields you want to change, save the file, and close the editor. The command applies only the changed fields to the Shadow Link.

You cannot change the Shadow Link name. If you need to rename a Shadow Link, delete it and create a new one with the desired name.

The editor respects your EDITOR environment variable. If EDITOR is not set, the command uses `vi` on Unix-like systems.

## [](#usage)Usage

```bash
rpk shadow update <link_name> [flags]
```

## [](#examples)Examples

This section provides examples of how to use `rpk shadow update`.

Update a shadow link configuration.

```bash
rpk shadow update my-shadow-link
```

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