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

# Taxonomy

Taxonomies are terms used to categorize learning content. Terms are grouped into vocabularies, which help organize and filter trainings.

<Note>
  **NOTE:** The Taxonomies dashboard is available only to **administrators** and **root-level** **content editors** (users with no hierarchy level assigned).
</Note>

You can access the Taxonomy dashboard from the menu on the left:

<img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_185906975.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=6def535a585063c2e609430c391e4548" alt="Image 2026 02 17 185906975" title="Image 2026 02 17 185906975" className="mx-auto" width="1024" height="573" data-path="images/image_2026-02-17_185906975.png" />

## Managing vocabularies

Two vocabularies are available by default:

* **LP Domain:** Classifies trainings by topic, allowing sorting and filtering by domain.
* **LP Duration:** Indicates the expected time required to complete a training.

You can rearrange the display order of vocabularies and add new terms to them, but you cannot delete a vocabulary.

**Opigno’s Custom API** allows creating and editing custom vocabularies. To do that, click **Add vocabulary**. This opens a dedicated interface where you can define the vocabulary’s name, description, and language settings:

<img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_190317861.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=4e621b984c1310523ad6174ce899c986" alt="Image 2026 02 17 190317861" title="Image 2026 02 17 190317861" className="mx-auto" width="1024" height="852" data-path="images/image_2026-02-17_190317861.png" />

## Managing terms

To view or manage the terms in a vocabulary, click **List terms** next to it on the main dashboard.\
From this interface, you can create, edit, publish/disable, delete, rearrange, or group terms:

<img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_190337028.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=e3f34b3491e57628040379be1e99f2c7" alt="Image 2026 02 17 190337028" width="1024" height="459" data-path="images/image_2026-02-17_190337028.png" />

### Creating a new term

To add a new term, click **Add term**, which opens the dedicated term creation form:

<img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_190348310.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=9f640a392e5ca9b87efbc2e9fa43f119" alt="Image 2026 02 17 190348310" title="Image 2026 02 17 190348310" className="mx-auto" width="1024" height="925" data-path="images/image_2026-02-17_190348310.png" />

**Opigno’s Custom API** enables restricting a term to a specific hierarchy level, so content managers only see the terms assigned to their hierarchy when creating trainings.

Click **Save** to save the new term and stay on the current interface to start creating another term.\
Click **Save and go to list** to save the new term and exist to the list of vocabulary terms.

### Editing a vocabulary term

Click the **Edit** action button in the list of vocabulary terms to open a dedicated interface where you can change the term and its parameters or delete it.

<img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_190417822.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=e9d8aa6ee4e1f3288fca9a7f393260b6" alt="Image 2026 02 17 190417822" width="1024" height="878" data-path="images/image_2026-02-17_190417822.png" />

Deleting a term automatically deletes all its translations as child entities. The system will list all the affected term entities.

<Frame>
  <img src="https://mintcdn.com/connect-i/SwaIk0g9xdL1JO6M/images/image_2026-02-17_190430314.png?fit=max&auto=format&n=SwaIk0g9xdL1JO6M&q=85&s=34c55ebef7c0ec40dffe0e6bad466696" alt="Image 2026 02 17 190430314" width="1024" height="644" data-path="images/image_2026-02-17_190430314.png" />
</Frame>

You can also delete the term selectively from a specific hierarchy **(Opigno Custom API is required)**.
