# ALTER ICEBERG CATALOG

> 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 ICEBERG CATALOG
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: sql/sql-statements/alter-iceberg-catalog
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-iceberg-catalog.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/reference/pages/sql/sql-statements/alter-iceberg-catalog.adoc
description: The ALTER ICEBERG CATALOG statement modifies connection properties of an existing Iceberg catalog.
page-topic-type: reference
page-git-created-date: "2026-05-26"
page-git-modified-date: "2026-05-26"
---

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

The `ALTER ICEBERG CATALOG` statement modifies connection properties of an existing Iceberg catalog. You must repeat the `STORAGE` clause when altering, even if the storage connection is not changing.

## [](#syntax)Syntax

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

-   `catalog_name`: Name of the Iceberg catalog to modify.

-   `IF EXISTS`: Optional. Prevents an error if the Iceberg catalog does not exist.

-   `storage_name`: Name of the storage connection backing the catalog.

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


## [](#examples)Examples

Update the REST catalog URI for an existing Iceberg catalog:

```sql
ALTER ICEBERG CATALOG lakehouse_catalog STORAGE iceberg_storage
WITH (uri = 'https://new-catalog.example.com');
```

Rotate the basic-authentication credentials on an existing Iceberg catalog:

```sql
ALTER ICEBERG CATALOG lakehouse_catalog STORAGE iceberg_storage
WITH (
  auth_type = 'basic',
  username = '<new-username>',
  password = '<new-password>'
);
```