# Label Set Management

Datasaur helps users maintain their label set in a team workspace. Editing and reusing label sets can be done through your project workspace and project creation wizard. We also preserve a menu for you to manage your label set.

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

1. **Label set name**: This is the title given to the label set, providing a clear identifier for its contents.
2. **Label class**: The specific labels used for annotation. In the example above, "GEO," "ORG," "PER," and "GPE" are label classes.
3. **Label color**: The color associated with each label class, making it visually distinct and easy to identify at a glance.
4. **Label clarification**: A brief explanation of label classes and their intended use.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-131d060ca797bd3c6ac32491ccc68862eb90d713%2Fimage%20(15).png?alt=media" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Editing the label set in Label management **will not** automatically apply changes to the corresponding label set within the project.
{% endhint %}

![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-b05bcd7945a910ee6e8e86abf403b671991b03f2%2FLabel%20management%20-%20label%20sets.png?alt=media)

User can do several things, such as:

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

There are two ways to add label sets.

**A. Upload a Label Set**

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

Refer to the sample format below to ensure compatibility.

{% file src="<https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-1b2ae3fb22653f442ec5afacc5d0ca8e965ca191%2FLabel%20set%20sample.csv?alt=media>" %}

{% file src="<https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-b8719d130f7ca52347b64360b3f7f71b414020c2%2FLabel%20set%20sample%20(1).json?alt=media>" %}

{% file src="<https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-6a9542ce5cdf2c51c764e7b8f2c9b5333c2d2c8b%2FLabel%20set%20sample.tsv?alt=media>" %}

**B. Create a Label Set from Scratch**

You can also create a label set directly. The Standard and JSON tabs are synchronized, changes in one tab automatically update the other.

When creating a label set from scratch in the Standard tab:

* Add a label class: Click the text field and enter the label name.
* Choose a label color: Click the color dropdown and select your preferred color.
* Add a clarification: Click the “Add clarification” icon beside the label name field and enter the clarification text.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-c3313a76fb954a933d0e25025c6029c080b5a0b0%2Fimage%20(18).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-187459eae8187d1b7077055b6606d01b7e8c7218%2Fimage%20(20).png?alt=media" alt=""><figcaption></figcaption></figure>

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

You can edit a label set in two simple steps:

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

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-a71153cb7c7bebeedd1820491503744253d63a69%2Fimage%20(23).png?alt=media" alt=""><figcaption></figcaption></figure>

Once in edit mode, you can update individual label items and their properties:

* Rename a label class: Hover over the label and click the text field to enter a new name.
* Change the label color: Click the color dropdown and select a different color.
* Edit the clarification: Click the Edit clarification icon and update the text.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-cc210d05a5b8a517095aa94af10355b03ed38f56%2Fimage%20(25).png?alt=media" alt=""><figcaption></figcaption></figure>

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

Deleting a label set can be accomplished by following these three quick steps.

1\. Select the label set (one or multiple).

2\. Click the **Delete** button on the left to delete multiple label sets, or the delete icon on the right side to delete a single label set.

3\. Confirm the action.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-caaf7e449ce934715b96d5f4d4b19c1a48d93c6b%2Fimage%20(26).png?alt=media" alt=""><figcaption></figcaption></figure>

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

Users can search the label set by typing keywords into the search bar that represent their label set.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-10410e248442005eb0d147667b60df71ae812f0a%2FLabel%20management%20-%20label%20sets%20-%20search.png?alt=media" alt=""><figcaption></figcaption></figure>

## Project Creation Wizard <a href="#project-creation-wizard" id="project-creation-wizard"></a>

In step 3, user can choose span/conversational labeling and do several things for their label sets, such as:

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-cfa5780a403bd152beae6afa8d17aa5ec7523c20%2FPCW%20-%20Step%203%20-%20span%20labeling.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Use Label Set from Library**

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-461858f9d3e1563cc6c0e84541c92f8cd00c313b%2FPCW%20-%20Step%203%20-%20span%20labeling%20-%20select%20label%20set%20from%20library.png?alt=media" alt=""><figcaption></figcaption></figure>

* To use an existing label set, user must select one of the pre-stored label sets in the library.
* Any modifications towards the label set in this page will not change the original question set in the library.

### **Edit Label Set**

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-8285566e5ec7a2aa8090d9dd7218b07ca753cb94%2FPCW%20-%20Step%203%20-%20edit%20label%20from%20library.png?alt=media" alt=""><figcaption></figcaption></figure>

* Any modifications towards the label set in this page will not change the original label set in the library.

## Within a Project

After a project is created, Admins can modify the label set if needed. Learn more [here](https://docs.datasaur.ai/advanced/extensions/labels#label-set-modification).
