> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/database/taxonomies/delete.md).

# Delete a taxonomy

Delete a taxonomy you no longer use.

**Where:** Database → Taxonomies → row menu → **Edit taxonomy** → **Delete** · `/projects/<project>/db/taxonomies/<taxonomyName>/edit`

## Before you start

* You need `database:delete` on the taxonomy (`database:taxonomy:<id>`, or `database:taxonomy:all`).
* Check that no records, and no other taxonomy (as **Parent** or **Additional category**), still use it.

## Steps

1. Open **Database → Taxonomies**, open the row menu of the taxonomy and choose **Edit taxonomy**.
2. Press **Delete** at the top right. The dialog **Delete Confirmation** asks *Are you sure you want to delete?*

   <figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-b0c0368bec8ecb6fa7e7e0aa7bc8550ed8f7c130%2Ftaxonomies-delete-1.png?alt=media" alt="Editing Old_labels taxonomy behind the dialog Delete Confirmation: Are you sure you want to delete? with Cancel and Delete"><figcaption><p>The confirmation dialog.</p></figcaption></figure>
3. Press **Delete**. **Cancel** keeps the taxonomy.

## Result

Cloud goes back to the taxonomies list and the taxonomy is gone.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-2d858f578bd05272f0396459ae6f3c51e4088b0e%2Ftaxonomies-delete-2.png?alt=media" alt="Taxonomies list with Regions, Tags and Countries; Old_labels is gone"><figcaption><p>The list after the delete.</p></figcaption></figure>

## Change or remove it later

A deleted taxonomy cannot be restored from Cloud. [Create it again](/codemash/cloud/database/taxonomies/new.md) with the same name; it gets a new id and no terms.

## Do it from code

```ts
await norbix.hub.database.deleteDatabaseTaxonomy({ id });
```

```sh
norbix hub database taxonomy delete --id txn_6IWiapNDOobxMHQ7ij0zTh --yes
```

The client setup is on the [Database page](/codemash/cloud/database.md#use-it-from-code). API: [Delete Database Taxonomy](/codemash/api-reference/database/taxonomies/delete-database-taxonomy.md)
