> 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-3ce68d0b96e3f45eec245ea0cb90a1aa2bf1e2c7%2FExtension%20%20-%20row%20doc%20labeling%20-%20row%20-%20more%20menu.png?alt=media" alt=""><figcaption><p>Row labeling extension</p></figcaption></figure>
{% endtab %}

{% tab title="Document labeling" %}

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-f8dda44ae3445783c4dae3a164c19ef0662197b7%2FExtension%20%20-%20row%20doc%20labeling%20-%20document%20-%20more%20menu.png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-3ce68d0b96e3f45eec245ea0cb90a1aa2bf1e2c7%2FExtension%20%20-%20row%20doc%20labeling%20-%20row%20-%20more%20menu.png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-1537b94fc24d2378a4595da22f2b863591b748a0%2FExtension%20%20-%20row%20doc%20labeling%20-%20select%20question%20set%20from%20library.png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-48470dfa6b136d39b075091cb8e7b76bada98f68%2FExtension%20%20-%20row%20doc%20labeling%20-%20Edit%20question%20set%20(1).png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-48470dfa6b136d39b075091cb8e7b76bada98f68%2FExtension%20%20-%20row%20doc%20labeling%20-%20Edit%20question%20set%20(1).png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-2fbca061d6391c3c76ab9241f086c883a598ae7c%2FExtension%20%20-%20row%20doc%20labeling%20-%20more%20menu%20-%20Disable%20keyboard%20shortcut.png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-e494afd53924813b71a4fe2f91eda57b31df4eb7%2FExtension%20%20-%20row%20doc%20labeling%20-%20more%20menu%20-%20Match%20shortcuts%20to%20numeric%20labels%20in%20dropdowns.png?alt=media" 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="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-6fb31dab8fc268f469fb5c08c58f4d5568eaf572%2FExtension%20%20-%20row%20doc%20labeling%20-%20match%20shortcuts%20disabled.png?alt=media" alt=""><figcaption><p>Shortcuts don't match the numeric labels</p></figcaption></figure>
{% endtab %}

{% tab title="Enabled" %}

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-9bf3aa3b7aa6c81754d8d57ec6019c517968c561%2FExtension%20%20-%20row%20doc%20labeling%20-%20match%20shortcuts%20enabled.png?alt=media" 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.
