> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/core-concepts/label-sets-ontologies.md).

# Category Schema (Ontologies)

Setting up your labeling project's ontology on Ango Hub

A project’s category schema (also known as *ontology*) is the list of labeling tools available in the project.

Ango Hub allows project owners to set the project’s ontology directly from the *Category Schema* section of the *Settings* page.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FRn0U6LR28eZUide9gOof%2Fimage.png?alt=media&amp;token=da9020ce-fb63-4b3d-8b7c-79b9c455d78c" alt=""><figcaption></figcaption></figure>

The ontology created from this section is then reflected in the left sidebar of the labeling editor:

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FFH9PGJO4sgkH3AkmNuJZ%2FScreen%20Shot%202021-12-17%20at%2014.16.29.png?alt=media\&token=d9cb5f28-77a1-4be1-96ea-013b25330aba)

## How to create a project ontology <a href="#how-to-create-a-project-ontology" id="how-to-create-a-project-ontology"></a>

From the project’s *Settings* tab, enter the *Category Schema* section.

Click on the *Add Category* button and choose the labeling tool to add. Each tool has a slightly different setup process. [See here for a list of all labeling tools available in Ango Hub, and how to add them to your project.](/labeling/labeling-tools.md)

For a guide on how to create nested classifications, [see here](/labeling/labeling-tools/tools/nested-classifications.md).

## Make categories read-only in specific stages

From **Settings > Category Schema**, expand a tool or classification. In **Read-only Stages**, select the Label, Review, or Consensus stages where the category should be locked, then click **Save**. Selecting a Consensus stage applies to all its branches.

At the selected stages, annotators cannot create annotations with that category or edit, move, or delete existing ones. The annotations remain visible and are exported as usual. A padlock identifies read-only categories in the editor. At other stages, the category remains editable.

Nested classifications follow their parent category's setting. To change or remove a restriction, return to **Read-only Stages** and update the selection. If a selected stage is deleted from the workflow, it appears as **Deleted stage** and can be removed from the list.

{% hint style="info" %}
This setting is not available in 3D MSFT projects. It differs from disabling a category with the category schema's padlock, which only prevents new annotations and still allows existing ones to be edited.
{% endhint %}

## How to copy a project's ontology to a new project

Please [check this guide](/how-to/transfer-project-ontologies-between-projects.md).

## Browse and Restore Previous Ontology Versions

From the Settings tab, in the *Category Schema* section, click on the "History" icon on the top-right to open a history of all workflow versions in the current project.

{% hint style="info" %}
Category Schema history started being recorded on March 12, 2025. Versions before then had not been saved.
{% endhint %}

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FwyxjEvBJZtzcj2PHFq9B%2Fimage.png?alt=media&amp;token=73d3cf1d-7daa-46f9-97f9-d30e42df4e76" alt=""><figcaption></figcaption></figure>

To view a previous version of this project's ontology, click on *Preview*. To restore it, click on *Save* while the version you need is previewed.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.imerit.net/core-concepts/label-sets-ontologies.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
