> 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/document-and-row-labeling.md).

# Document and Row Labeling

## Overview

The **Document labeling** and **Row labeling** extensions display the question sets configured during project creation, allowing users to answer questions for each row or document.

{% tabs %}
{% tab title="Row labeling" %}

<figure><img src="/files/3i3q7zrXa0lS6z2zPgCF" alt=""><figcaption><p>Row labeling extension</p></figcaption></figure>
{% endtab %}

{% tab title="Document labeling" %}

<figure><img src="/files/Q3hLDzjj11GUNoig9KL4" alt=""><figcaption><p>Document labeling extension</p></figcaption></figure>
{% endtab %}
{% endtabs %}

## Question set modification

You can manage and update question sets either from the **Label management** page in your workspace or directly within a project. This includes adding new question sets, editing existing ones or removing them. Learn more about [label set management](/workspace-management/label-management/label-set-management.md).

Within a project, question sets can be modified from the three-dot menu in the extension.

<figure><img src="/files/3i3q7zrXa0lS6z2zPgCF" alt=""><figcaption></figcaption></figure>

### Upload a new question set

You can add or replace a question set in two ways:

* **From the three-dot menu.**
* **Using the file uploader** (only shown only when no question set is configured).

### Use existing question set

This option lets you select a saved question set from the library. Using a different question set will:

* Replace the current question set.
* Remove existing answers associated with the previous set.

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

### Edit question set

You can modify question sets even after the project has started. You can add new questions, edit existing ones, or remove them.

{% hint style="info" %}
Changes made inside a project do not automatically update the corresponding question set in the **Label management** page.
{% endhint %}

#### Add questions

Click the add icon to add a new question to the current question set.

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

#### Edit question

Select the question you want to modify and update its settings as needed. You can update both display-related properties and functional behavior:

* **Display-related properties**:
  * Question name.
  * Slider color.
  * Date/time format.
  * Other visual properties.
* **Question type**: Change the question to a different type.
  * Switching between **Text** and **Text area** keeps existing answers.
  * Switching to any other question type removes previous answers.
* **Required or optional:** Choose whether the question must be answered or can be skipped. If existing answers no longer match the updated setting, labelers will be asked to review them.
* **Single or multiple answers**: Change whether the question allows one answer only or multiple answers. If existing answers no longer match the updated setting, labelers will be asked to review them.
* **Answer options**: Add, rename, or delete options.
  * Adding options gives labelers more choices.
  * Renaming options updates only the displayed text and keeps existing answers.
  * Deleting options removes answers associated with those options.
* **Regex validation**: Add or update regex rules to validate text input. If existing answers no longer match the updated setting, labelers will be asked to review them.
* **Slider range**: Update the minimum or maximum slider value. Answers outside the updated range will display a warning in the labeling extension.
* **Remove questions:** You can remove both newly added and existing questions when needed.

Questions that have already been submitted have the following limitations:

* They cannot be removed or reordered.
* Dynamic question sets cannot be modified.

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

### Save to library

Save the current question set to your library (**Label management** page) so it can be reused in other projects.

## Keyboard shortcuts

### Disable keyboard shortcut

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

This option disables numeric keyboard shortcuts for selecting answers.

If this option is disabled, **Match shortcuts to numeric labels in dropdowns** will also be disabled.

### Match shortcuts to numeric labels in dropdowns

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

This option makes dropdown shortcuts use the same numeric values as the dropdown options. For example:

| Dropdown option | Default shortcut | Match shortcuts enabled |
| --------------- | ---------------- | ----------------------- |
| **0**           | Shortcut 1       | Shortcut 0              |
| **1**           | Shortcut 2       | Shortcut 1              |
| **4**           | Shortcut 3       | Shortcut 4              |

{% tabs %}
{% tab title="Disabled" %}

<figure><img src="/files/toGWAHFppbe4zmIwgT6F" alt=""><figcaption><p>Shortcuts don't match the numeric labels</p></figcaption></figure>
{% endtab %}

{% tab title="Enabled" %}

<figure><img src="/files/3VqRr5i7tGv2mnSGFU3u" alt=""><figcaption><p>Shortcuts match the numeric labels</p></figcaption></figure>
{% endtab %}
{% endtabs %}

This option only works when:

* The project contains at least one dropdown question.
* Keyboard shortcuts are enabled.
* All dropdown options are single-digit numbers between 0 and 9.
  * If any dropdown option is not a number between 0 and 9, this feature will not apply.

## Discard draft from current document

This option removes any unsaved or unsubmitted changes in the current document. Use it when you want to discard your current progress and start again.