> For the complete documentation index, see [llms.txt](https://docs.datasaur.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasaur.ai/advanced/extensions/bounding-box-labels.md).

# Bounding Box Labels

The **Bounding box labels** extension is a core extension for bounding box labeling projects. It contains the label set (taxonomy) used for labeling.

You can add a label set in two ways:

* Upload a label set with a `.csv` , `.tsv` or `.json` format.
* Enter the labels in manually.

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

{% hint style="info" %}
In the project, you can also click a label instance to jump directly to its corresponding bounding box and open the label box for that item.
{% endhint %}

## Label set modification

If you created a project without a label set, you can add one anytime by:

* Dragging and dropping a label set file.
* Using the three-dot menu.

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

To edit an existing label set, click the three-dot menu and select **Edit label set.**

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

The **Edit label set** dialog will open, allowing you to update the label classes and their configuration.

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

To replace the current label set, click the three-dot menu and select **Replace existing label set.**

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

You can then upload a new label set file or create it from scratch.

<figure><img src="/files/2evC7i2LpSd3P0XWayFv" alt=""><figcaption></figcaption></figure>

### Permissions

By default, both reviewers and labelers can modify label sets. To restrict this capability for labelers:

1. Go to **File > Settings > Administrator.**
2. Disable the **Label set modification** option.

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

## Custom attributes for label classes

Each label class can include multiple custom attributes (questions). The question types are limited to [text](https://docs.datasaur.ai/advanced/extensions/pages/sjMjHjQsHtR5BrPf3PUF#id-1.-text-field) and [dropdown](https://docs.datasaur.ai/advanced/extensions/pages/sjMjHjQsHtR5BrPf3PUF#id-3.-dropdown). Each question can have a default answer.

To update custom attributes in a label set:

1. Open the label set editor.

   ![](/files/sprYc4OVHpmr6Fq7xTYd)
2. Switch to the **JSON** tab.

   ![](/files/JPt3rNIbnrwZWF3zLeVX)
3. Add or modify the <mark style="color:red;">`questions`</mark> field for the desired label class.

{% hint style="info" %}
Modifying the `type` or `internalId` of existing questions is not supported because it can affect previously applied labels unexpectedly.
{% endhint %}

#### Question structure

The <mark style="color:red;">`questions`</mark> field can contain multiple questions with the following properties:

1. **id**: ID of the question.
2. **label**: The question name.
3. **type**: The type of question. It can be <mark style="color:red;">`TEXT`</mark> or <mark style="color:red;">`DROPDOWN`</mark>.
4. **config**: Configuration settings for the question.
   1. **required**: Determines whether the question must be answered. It can be <mark style="color:red;">`true`</mark> or <mark style="color:red;">`false`</mark>.
   2. **defaultValue**: The default answer for the question.
      1. For <mark style="color:red;">`TEXT`</mark> questions, it can be any text.
      2. For <mark style="color:red;">`DROPDOWN`</mark> questions, it must be an <mark style="color:red;">`options.id`</mark> value.
   3. **multiline**: Specifies if the <mark style="color:red;">`TEXT`</mark> question allows multiple lines. It can be <mark style="color:red;">`true`</mark> or <mark style="color:red;">`false`</mark>.
   4. **options**: An array of options for the <mark style="color:red;">`DROPDOWN`</mark> question, each containing:
      1. **id**: ID of the dropdown option. It can be used in the <mark style="color:red;">`defaultValue`</mark>.
      2. **label**: The text label for the dropdown option.
5. **internalId**: Read-only unique ID used internally by Datasaur.

{% hint style="info" %}
For a detailed example, refer to the [Label Sets](/data-studio-projects/lets-get-labeling/bounding-box-labeling.md#label-sets) documentation for a sample bounding box label set with custom attributes.
{% endhint %}