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

# Taxonomies

Manage taxonomies

### Manage taxonomies

The main taxonomy dashboard looks like this:

<figure><img src="https://3235524095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fiyf0tSKPgXiyoQ3zV3I6%2Fuploads%2FXUNIbAylqve1z22a0wrh%2FRegistered-Taxonomies-%E2%80%B9-Localhost-%E2%80%94-WordPress%20(1).png?alt=media&amp;token=88864be2-53e2-4861-90f5-6c427ec581eb" alt=""><figcaption></figcaption></figure>

From the main dashboard you can run these operations:

* **Create a new taxonomy**
* **Update an existing taxonomy**
* **View a registered taxonomy**
* **Delete a registered taxonomy**

Once you install ACPT or ACPT Lite plugin, a sync process with already registered taxonomies is performed automatically.

Please note that ACPT imports category and post\_tag taxonomies labeled as "Native".

### Register a new taxonomy

From the main dashboard click on the "**Register new Taxonomy**" button to create a new taxonomy:

The creation of a new taxonomy is a three steps process:

* **STEP 1: Basic**
* **STEP 2: Labels**
* **STEP 3: Settings**

#### Basic (Minimum configuration)

This is the most important step. Define here:

* **Slug**: The post name/slug. Used for various queries for taxonomy content. ACPT automatically escapes the slug for you.
* **Singular label**: Used only in the admin panel when a singular label is needed
* **Plural label**: Used only in the admin panel for the post type admin menu item

#### Labels (Additional labels)

Labels used in the admin panel for standard WordPress operations (searching terms, adding new content, etc.).

The defaults work well in most situations. Change them if you need specific wording in your admin interface.

#### Settings (Other settings)

Additional taxonomy settings. Leave the defaults in place unless you have a specific requirement.

Once you complete the three steps, you will be able to associate the new taxonomy with a post type.

Please refer to the [official WordPress documentation](https://developer.wordpress.org/reference/functions/register_taxonomy/) to get more info about registering new taxonomies.

### Reserved Terms

According to WordPress documentation, avoiding the following [reserved terms](https://developer.wordpress.org/reference/functions/register_taxonomy/#reserved-terms) is particularly important, because it can cause WordPress to respond with a 404 error without any other hint or explanation.

For this reason, **ACPT will not allow you to use any of those reserved terms**:

<figure><img src="https://3235524095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fiyf0tSKPgXiyoQ3zV3I6%2Fuploads%2Fm6mIh9X0Oq2Ew38ENKgq%2FCreate-new-Taxonomy-%E2%80%B9-ACPT-Demo-%E2%80%94-WordPress.png?alt=media&amp;token=0bca1f7b-ef43-495e-a71d-782fff74afad" alt=""><figcaption></figcaption></figure>

### Update an existing taxonomy

You have two ways to edit a taxonomy:

* Click the **Edit** link in the taxonomy dashboard.
* Click the **Edit** link in View mode — this takes you directly to the relevant step.

The update process is identical to the creation process, with one exception: the taxonomy slug cannot be changed after creation.

### View a registered taxonomy

By clicking the View link in the dashboard you can view a taxonomy.

The View mode is divided into three tabs, like the 3-step creation process.

### Delete a taxonomy

By clicking the Delete link in the dashboard you can delete a taxonomy.

It's very important to understand that this operation **DOES NOT DELETE anything on the terms WordPress DB table**, but only the ACPT settings. After deleting a taxonomy you will no longer display it in the admin panel, even if the taxonomy records are still present. If you try to re-create the same taxonomy you will see the old data.

Note that Native taxonomies (such as `category` and `post_tag`) cannot be deleted.