---
title: "schema rename"
slug: "schema-rename"
updated: 2026-10-27T17:24:38Z
published: 2026-10-27T17:24:38Z
canonical: "docs.vastdata.com/schema-rename"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# schema rename

This command renames a VAST Database schema.

## Usage

```plaintext
schema rename --database-name DATABASE
              --name OLD_SCHEMA_NAME
              --new-name NEW_SCHEMA_NAME
             [--tenant-id TENANT]          
```

## Required Parameters

| `--database-name DATABASE` | Specifies the name of the database that contains the schema. |
| --- | --- |
| `--name OLD_SCHEMA_NAME` | Specifies the name of the schema to be renamed. |
| `--new-name NEW_SCHEMA_NAME` | Specifies the new name for the schema. The name must meet the requirements for S3 object names. |

## Options

| `--tenant-id TENANT` | Specifies the ID of the tenant where the database resides If omitted, the default tenant is assumed. |
| --- | --- |

## Example

This example shows renaming a schema named `schema1` into `abcd`:

```plaintext
vcli: admin> schema rename --name schema1 --database_name vastdb --new-name abcd
```