# ALTER STORAGE

> 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: ALTER STORAGE
latest-operator-version: v26.2.1
latest-console-tag: v3.10.0
latest-connect-version: 4.104.0
latest-redpanda-tag: v26.2.1
docname: sql/sql-statements/alter-storage
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: sql/sql-statements/alter-storage.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/reference/pages/sql/sql-statements/alter-storage.adoc
description: The ALTER STORAGE statement modifies credentials or configuration of an existing storage connection.
page-topic-type: reference
page-git-created-date: "2026-05-26"
page-git-modified-date: "2026-08-03"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/reference/sql/sql-statements/alter-storage.md -->

The `ALTER STORAGE` statement modifies the credentials or configuration of an existing storage connection.

> 📝 **NOTE**
>
> In Redpanda Cloud, the storage connection and Iceberg catalog used to query Iceberg-enabled topics are configured and managed automatically when you enable Redpanda SQL on a cluster that has an [Iceberg REST catalog](https://docs.redpanda.com/cloud-data-platform/manage/iceberg/rest-catalog/) configured. You don’t run these statements yourself for that workflow. This page documents the statement’s syntax and options so you can understand what Redpanda Cloud configures. See [Query Iceberg-enabled topics](https://docs.redpanda.com/cloud-data-platform/sql/query-data/query-iceberg-topics/).

## [](#syntax)Syntax

```sql
ALTER STORAGE [IF EXISTS] storage_name
WITH (option = 'value' [, ...]);
```

-   `storage_name`: Name of the storage connection to modify.

-   `IF EXISTS`: Optional. Prevents an error if the storage connection does not exist.

-   `option = 'value'`: One or more options to update. See [CREATE STORAGE](https://docs.redpanda.com/cloud-data-platform/reference/sql/sql-statements/create-storage/) for the full list of options.


## [](#examples)Examples

Update the region for an existing storage connection:

```sql
ALTER STORAGE archive_storage
WITH (region = 'eu-west-1');
```