---
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: 476
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/admin/databases/rename/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

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

> [!Note]
> 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.

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/)