---
title: "Vocabularies Overview"
slug: "vocabularies-overview"
updated: 2026-09-09T13:59:30Z
published: 2026-09-09T13:59:30Z
canonical: "docs.discngine.com/vocabularies-overview"
---

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

# Vocabularies Overview

In this page, you can browse through the existing vocabularies or create a new one. You can easily locate a vocabulary of interest by performing a keyword search against any of its attributes (name, description, etc.).

![Vocabularies Reference Data](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/refdata-voc-new.png?sv=2026-02-06&spr=https&st=2026-11-10T21%3A15%3A49Z&se=2026-11-10T22%3A15%3A49Z&sr=c&sp=r&sig=e4tG46ZDIfpVnY1zu4odz4mxGg4kPpxOFNGuSAHtMRk%3D)

              
              

You can only add and edit a vocabulary if you have the Reference Data Administrator role. Other users can only view the vocabularies and their items (Reference Data User).

Vocabularies can also be automatically created and imported using our API. Please ask the support team for more details.

## Add a vocabulary

To add a vocabulary, click the `New Vocabulary` button at the top left. You will be redirected to a modal dialog where you can enter:

- Name
- Short name (optional, for display purposes)
- Description (optional - highly recommended)
- Public URI:
  - If you create your own proprietary vocabulary, leave this empty. It will be auto-generated by the system.
  - If you are importing a public ontology, enter its URI.

Click the `Create` button to create the vocabulary.

![Create vocabulary](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/refdata-voc-create.png?sv=2026-02-06&spr=https&st=2026-11-10T21%3A15%3A49Z&se=2026-11-10T22%3A15%3A49Z&sr=c&sp=r&sig=e4tG46ZDIfpVnY1zu4odz4mxGg4kPpxOFNGuSAHtMRk%3D)

## Edit or delete a vocabulary

Similarly, you can edit an existing vocabulary by clicking the `Edit` button on the left side of the vocabulary list.

- The name, short name, and description can be updated.

![Edit vocabulary](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Setting/refdata-voc-update.png?sv=2026-02-06&spr=https&st=2026-11-10T21%3A15%3A49Z&se=2026-11-10T22%3A15%3A49Z&sr=c&sp=r&sig=e4tG46ZDIfpVnY1zu4odz4mxGg4kPpxOFNGuSAHtMRk%3D)

From this page, you can also delete the vocabulary by clicking the `Delete` button. This will remove the vocabulary and all its items from the system.

              
              

Be careful, the delete action cannot be undone.

## Vocabulary items

In each vocabulary, you can create items that represent the terms within the vocabulary. These items can be arranged in a hierarchy, allowing for a structured representation.

To access the items, click the vocabulary name in the list. You will be redirected to a page where you can view the items and their hierarchy.

For instructions on how to use this page, see the [Vocabulary Items guide](/public/docs/vocabularies-items-details).