---
title: Rename a database
description: Use the influxctl database rename command to rename a database in your InfluxDBed cluster.
url: https://docs.influxdata.com/influxdb3/clustered/admin/databases/rename/
estimated_tokens: 775
product: InfluxDB Clustered
version: clustered
---

# Rename a database

Use the [`influxctl database rename` command](/influxdb3/clustered/reference/cli/influxctl/database/rename/) to rename a database in your InfluxDBed cluster.

Renaming a database does not change the database ID, modify data in the database, or update [database tokens](/influxdb3/clustered/admin/tokens/database/). After renaming a database, any existing database tokens will stop working and you must create new tokens with permissions for the renamed database.

If you create a new database using the previous database name, tokens associated with that database name will grant access to the newly created database.

## Rename a database using the influxctl CLI

```sh
influxctl database rename DATABASE_NAME NEW_DATABASE_NAME
```

Replace the following:

-   `DATABASE_NAME`: Current name of the database to rename
-   `NEW_DATABASE_NAME`: New name for the database

## Update database tokens after renaming

After renaming a database, existing database tokens will no longer work because they reference the old database name. Do the following:

1. [Create new database tokens](/influxdb3/clustered/admin/tokens/database/create/) with permissions for the renamed database.
2. Update your applications and clients to use the new tokens.
3. [Delete the old database tokens](/influxdb3/clustered/admin/tokens/database/delete/) that reference the old database name.

#### Renamed database retains its ID

The database ID remains the same after renaming. When you list databases, you’ll see the new name associated with the original database ID.

#### Related

-   [influxctl database rename](/influxdb3/clustered/reference/cli/influxctl/database/rename/)
-   [Create a database token](/influxdb3/clustered/admin/tokens/database/create/)