# Entity

The entity labeling tool is a multi-functional tool, used in both audio and text labeling to identify entities.

{% hint style="info" %}
The Entity tool is supported across the Audio, and Text labeling editors.
{% endhint %}

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mj9Q2CMggO8ujraHZeP%2F-Mk6PkSagTqxzKOwanFv%2F-Mk6SwhUIWvzST6nZmQP%2Fimage.png?alt=media\&token=654266c5-2e0d-4b07-a52a-85021abf37d2)

## How to add an Entity tool to your project <a href="#how-to-add-an-entity-tool-to-your-project" id="how-to-add-an-entity-tool-to-your-project"></a>

From the project’s *Settings* tab, enter the *Label Set* section.

Click on *Add Category*. From the list that appears, click on *Entity*.

A new row will appear named *Entity*. Click on it to expand it.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FjGtM80Q1MVDftVi6rhxO%2Fimage.png?alt=media&#x26;token=170311a5-66fb-4082-aa5b-96b052d9aceb" alt=""><figcaption></figcaption></figure>

Give your entity tool a title.

Enable the *Required* toggle if you want to force labelers to place one. When the toggle is disabled, labelers will be able to save and move to the next asset without creating an entity.

{% hint style="info" %}
By default, when using the Entity tool on text assets, the content of the spans is included in the export for your convenience. If you wish to turn this feature off, please enable the *No Span Content* toggle in the entity class settings.
{% endhint %}

If you would like to ask labelers further questions, for example, if you want to show a further *radio* after placing the entity, click on *Add Classification* and add a further question. [More on nested questions here](https://docs.imerit.net/labeling/labeling-tools/tools/nested-classifications).

## How to Label an Entity <a href="#how-to-label-an-entity" id="how-to-label-an-entity"></a>

### Audio <a href="#audio" id="audio"></a>

From the *Tools* section on the left sidebar, select an *Entity* labeling tool, marked with an underlined *A* icon.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mj9Q2CMggO8ujraHZeP%2F-Mk6PkSagTqxzKOwanFv%2F-Mk6T7NwblaM6K6pBNel%2Fimage.png?alt=media\&token=022cbbf3-6e45-4f91-ae5a-eb2f19c18db6)

Click on the waveform where you’d like the annotation to start. Keep the left mouse button pressed and drag until where you’d like the annotation to end. Release the left mouse button.

You can change the start and end points of the annotation by selecting it by clicking it, then by dragging on one of the ends. You can drag the entire annotation by selecting it, then clicking and dragging from the middle of the label.

### Text <a href="#text" id="text"></a>

From the *Tools* panel on the left sidebar, select an *Entity* labeling tool, marked with an underlined *A*. (If none are present, only answer the questions in the *Questions* panel.)

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mj9Q2CMggO8ujraHZeP%2F-Mk6GrDAPMxdxM3QCl1T%2F-Mk6H2rrTnAvjDAUG8pq%2Fimage.png?alt=media\&token=6a7c53ab-4b89-4f01-84ff-73657170e999)

#### Character Mode

With the *Entity* tool selected, click and drag on text to highlight the span you’d like to label:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FurN9zI76eQMJB88dhKxG%2FKapture%202024-06-11%20at%2015.28.10.gif?alt=media&#x26;token=65e1d303-ec8d-4fdb-87d2-1f88e5f02a62" alt=""><figcaption></figcaption></figure>

#### Token Mode

Double click on a token to quickly annotate it. Double click and drag to add multiple tokens to a span:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FlkwtTZ3bvZXSKPXeYPEi%2FKapture%202024-06-11%20at%2015.31.54.gif?alt=media&#x26;token=aa1f2336-1044-40aa-8c51-46539165a415" alt=""><figcaption></figcaption></figure>

If the labels have nested questions, select a label by clicking on it, then right-click on each label and click on the menu item that appears to see and answer the nested questions.

#### Editing Text Spans

You may click on a text annotation, then drag and drop its ends to modify its length:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2F6vXTVcTrfUhMbe5keM19%2Feditable-span.gif?alt=media&#x26;token=8b7ab91f-4429-4917-a966-ca4e0c17b275" alt=""><figcaption></figcaption></figure>
