Editing catalog settings
Written by
Updated at October 30, 2026
You can edit the description and deletion protection settings for an existing Iceberg REST Catalog. Once a catalog is created, its name (metadata.name) and labels (spec.labels) cannot be changed.
Using the CLI
-
Open the
StacklandRestCatalogresource to edit it:kubectl edit stacklandrestcatalog <catalog_name> -n <namespace> -
Edit the parameters as needed:
spec.description: Catalog description of up to 256 characters.spec.deletionProtection: Deletion protection. Usetrueto enable protection orfalseto disable it.
-
Save your changes.
You can also edit and reapply the local manifest:
kubectl apply -f stacklandrestcatalog.yaml -n <namespace>
To change access to data, follow Assigning permissions for a catalog and Revoking permissions for a catalog.
Using the management console
- Open the project and select the catalog’s namespace.
- In the left-hand menu, select REST Catalog → Catalogs.
- Open the catalog and click Edit.
- Change the Description or toggle Deletion protection. The Name, Bucket, and Labels fields are read-only.
- Click Save.
To change a role or access scope of a user or group, edit the permission assignment.