# Label Set Management

With label set management, you can save and edit label sets outside a project. You can later reuse them in span labeling or conversational labeling projects.

## Label set structure <a href="#label-set-management-page" id="label-set-management-page"></a>

1. **Label set name**: The title of the label set that identifies its contents.
2. **Label class**: The labels used for labeling spans or arrows (for example: `GEO`, `ORG`, `PER`, `GPE`).
3. **Label color**: The color assigned to each label class for easy visual identification.
4. **Label clarification**: A short description of each label class and its usage.

<figure><img src="/files/L4NhXdZhKB7kBowKvCY6" alt=""><figcaption></figcaption></figure>

## Label set management page <a href="#label-set-management-page" id="label-set-management-page"></a>

{% hint style="info" %}
Changes made in the **Label management** page are not automatically applied to existing projects.
{% endhint %}

![](/files/4V2JkYOcnwtTge9YW8iT)

In the **Label sets** tab, you can add new label sets, edit existing label sets, or delete them.

### Add label set <a href="#add-label-set" id="add-label-set"></a>

There are two ways to add label sets: upload a label set or create it from scratch.

#### Upload a label set

You can upload an existing label set by dragging and dropping the file into the upload area. Supported formats: `.csv` , `.json` , and `.tsv` .

Refer to the sample format below to ensure compatibility.

{% file src="/files/gQ6GKRYXFAirMMAiwlxu" %}

{% file src="/files/w4wT371LlXaY95ZX3rdo" %}

{% file src="/files/rktoNIvZEMF0VbmfUAkE" %}

#### Create label sets from scratch

You can also create a label set manually. The dialog includes two tabs: **Standard** and **JSON.** These tabs are synchronized, changes in one tab automatically update the other.

To create a label set in the **Standard** tab:

1. Type a label class.
2. Choose a label color by selecting a color from the dropdown.
3. Click the **Add clarification** icon and enter the description to add additional information.

<figure><img src="/files/23oBDWV7OwohGb94Aoy9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/b1IuUxFF1PsVnI7R4zae" alt=""><figcaption></figcaption></figure>

### Edit label sets <a href="#edit-a-label-set" id="edit-a-label-set"></a>

To edit a label set:

1. Select the label set you want to edit.
2. Click the **Edit** icon on the right side.

<figure><img src="/files/i7HresWb1qd33iVSe9dI" alt=""><figcaption></figcaption></figure>

3. Update the label items and their properties. You can:
   1. Rename a label class by editing its name field.
   2. Change the label color using the color dropdown.
   3. Edit the clarification using the **Edit clarification** icon.

<figure><img src="/files/bQprMWBQWyAvFko5nfd7" alt=""><figcaption></figcaption></figure>

### Delete label sets <a href="#delete-a-label-set" id="delete-a-label-set"></a>

To delete a label set:

1\. Select one or multiple label sets.

2\. Click the **Delete** button at the top of the table to delete multiple label sets, or click the delete icon on the right side to delete a single label set.

3\. Confirm the action.

<figure><img src="/files/RE8t4UvDldP7tqtiBza2" alt=""><figcaption></figcaption></figure>

### Search label sets <a href="#search-a-label-set" id="search-a-label-set"></a>

You can search for label sets by entering keywords in the search bar.

<figure><img src="/files/KPHZb7P2Y29oJefw6UH8" alt=""><figcaption></figcaption></figure>

## Use existing label sets during project creation <a href="#project-creation-wizard" id="project-creation-wizard"></a>

To use an existing label set when creating a project:

1. In step 3 of project creation, select **Span labeling** or **Conversational labeling**.

   <figure><img src="/files/QvxFvnhmLhT48P961DWp" alt=""><figcaption></figcaption></figure>
2. Click **Select from library** to use an existing label set from the **Label management** page.

   <figure><img src="/files/KOokj5NfWBps5XI2DtOk" alt=""><figcaption></figcaption></figure>
3. After you select a label set, you can edit them. Any changes made here will not affect the original label set in the library.

   <figure><img src="/files/SfEgimVBhPiZaOcJZimj" alt=""><figcaption></figcaption></figure>

## Update existing projects with existing label sets

After a project is created, you can modify the label set if needed. You can reuse label sets from the **Label management** page.

If the **Label set modification** setting is turned off, only admins or project owners can modify label sets. If it is turned on, labelers can also modify them. This setting is turned on by default. For details, visit [question set modification](/advanced/extensions/document-and-row-labeling.md#question-set-modification).


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.datasaur.ai/workspace-management/label-management/label-set-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
