# rpk shadow update

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

Updates a shadow link.

This command opens your default editor with the current shadow link configuration, and allows you to 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

Update a shadow link configuration:

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

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -h, --help | - | Help for update. |
| --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. |