[Strong] and normal texts.
``` - `<strong>[Strong]</strong>` is one format - `and normal texts.` is another (unformatted) --- ### Enable or Disable to Annotate In the Text Classification Studio, you can create a layout of contents in the JSON format, where you can define enable or disable for annotation. Like reference contents, questionnaire, etc. Use the [JSON](https://docs.dataloop.ai/docs/text-json-format#input-json-format){target="_blank"} and edit the `"annotatable": true` field to enable the text block for annotation. ```JSON .... "formatting": "html", // Specifies that the content is HTML-formatted "elements": [ { "key": "task-a", // Unique ID for this content block "annotatable": true, // Set to true so annotators can label this "content": "text content.
" // HTML content for annotation }, .... ``` --- ### Create & Configure Recipe Use the recipe to create and configure labels, attributes, and annotation tools for your recipe. To make changes, follow the steps: 1. Select the **Recipes** from the left-side menu. 2. Locate the recipe of the text classification task and click it from the list. 3. Select the **Instructions** tab. 4. Locate the Text studio-related items in text files from the **Global Settings** section, and **Text Settings**:  1. **Allow annotating formatted text**: Allows to annotate texts are formatted, for example texts in **bold**. 2. **Display text blocks horizontally**: Horizontal view is available only when working with JSON files. --- ## Text Studio v2 ### Label Picker A Label Picker is a feature within the annotation studio that allows you to pick or select labels to assign to specific objects or elements in the data being annotated. You can perform the following activities on the Label Picker section. The available labels are determined in the **Recipe**.  - Scroll and click a label to activate it. - Use the search bar to easily find labels. - Resize the label list to better fit your number of labels by clicking and dragging the separator line. - Use the Shortcut keys to navigate between labels. --- ### Annotation Tools Annotation tools are designed to facilitate the process of data annotation. Data annotation involves adding metadata, labels, or tags to raw data, making it understandable for machines. Use the [recipe](https://docs.dataloop.ai/docs/instructions#annotation-tools) to configure the annotation tools available on the left-side panel. The list of supported tools follows: 1. **Selection**  tool: It allows users to interact efficiently with existing annotations. Here’s how it works: - **Selecting Annotations**: Click to select an annotation, or Shift key + click to select multiple annotations. - **Deselecting**: Click outside the selected area to deselect all. 2. **Text**  tool: It enables annotators to manually highlight specific spans of text within a document, visually marking them with a color-coded highlight associated with a label. Learn [how to create annotations?](/1-3-8/docs/text-studio-v2#using-the-text-tool) 3. **Classification**  tool: It is used to assign labels to an entire text document or textual item, rather than to specific portions or spans. It’s particularly useful in tasks where the overall theme, sentiment, purpose, or topic of the document is what matters. Learn [how to create annotations?](/1-3-8/docs/text-studio-v2#using-the-classification-tool) --- ### Annotations Tab The Annotations tab on the right-panel allows you to control and manage annotations involves utilizing the annotations list and attribute controls, particularly when attributes are configured in the Recipe.  [Learn more](https://docs.dataloop.ai/docs/annotation-studio-basics#annotations) about the annotations and actions available. #### Action Icons  - The **Annotation Focus** icon filters the annotation list to include only annotations currently visible on the screen. - The **Annotation Grouping** icon toggles between listing the annotations one by one or by label group. - The **Annotation Sort** icon allows sorting the annotation list by creation time, update date and time, label, or type. Hover over any annotation to see related actions: - Change the annotation label. - Toggle visibility using the **eye** icon. - Open issues on an annotation. - Move an annotation for review. [Learn more](https://docs.dataloop.ai/docs/create-qa-task#qa-process-example) about how these icons are used in quality assurance (QA) assignments. --- ### Item Tab The Item tab displays information according to the type of the selected item.  [Learn more](https://docs.dataloop.ai/docs/annotation-studio-basics#item) about the item and actions available. --- ### Item Info & Controls (Top-Panel) Item Info & Controls are available depends on the type of annotation studio. For the detailed information, refer to the following articles.  - [Undo-Redo](https://docs.dataloop.ai/docs/annotation-studio-basics#undoredo) - [Item description](https://docs.dataloop.ai/docs/annotation-studio-basics#item-description) - [Item info](https://docs.dataloop.ai/docs/annotation-studio-basics#item-info) - [Keyboard shortcuts](/docs/text-studio-v2#keyboard-shortcuts) - [PDF Viewer (Optional)](https://docs.dataloop.ai/docs/annotation-studio-basics#pdf-viewer-optional) - [Settings](/docs/text-studio-v2#settings) - [Copy Annotations from the Previous Item](https://docs.dataloop.ai/docs/annotation-studio-basics#copy-annotations-from-the-previous-item) #### Settings - **Text Direction (RTL)**: Toggle this option to switch text direction from `left-to-right` (LTR) to `right-to-left` (RTL). By default, it is left-to-right. - **Font Size**: Default is 12. Use the slider to adjust the font size as needed. #### Keyboard Shortcuts | Action | Keyboard Shortcuts | | --- | --- | | Save | S | | Delete | Delete | | Undo | Ctrl + Z | | Redo | Ctrl + Y | | Search Labels | Shift + L | | Search a label | Shift + 1-9 (for the sub-labels, use the Tab key) | | Navigate in label picker | Up and Down arrows | | Navigate to sub-label | Tab | | Navigate to parent label | Shift + Tab | | Select label in label picker | Enter | | Move selected annotations | Shift + Arrow Keys | | Previous Item | Left Arrow | | Next Item | Right Arrow | | Add Item Description | T | | Mark Item as Done | Shift + F | | Mark Item as Discarded | Shift + G | | Go to annotation list | Shift + ; | | Navigate in annotation list | Up and Down arrows | | Select/deselect an annotation | Space | | Hide/Show Selected Annotation | H | | Hide/Show All Annotation | J | --- ### Item's View Controls (Bottom-Panel) The controls on the bottom-side panel display based on the annotation contexts and work controls. #### Workflow Context Assignment controls, including moving between items, displaying the item gallery, and the status buttons (Complete / Discard). It displays only while working on an annotation or QA task. 1. Browse between the assignment items using the Left and Right arrows 2. Open the Thumbnails' gallery viewer, and click a thumbnail to open that item 3. Save button - Clicking the button when it is enabled triggers saving changes to the Dataloop platform, before the auto-saving feature takes care of that. 4. Status buttons - **Complete** and **Discard**. --- ### Studio Canvas The Text Studio Canvas serves as the main workspace for performing annotations.  In addition to annotation tasks, you can click on the label name to:  - **Modify** Labels & Attributes by clicking on the label name. - **Set Object ID** for better identification. - **Delete** annotations when necessary. #### Annotation Highlighting The **Annotation Highlighting** feature in Text Studio helps users clearly visualize selected annotations on the canvas. When more than four labels are added to the same text, only the **first four label colors** will be highlighted as a dashed border around the annotated characters. For example, When more than four labels are added to the same text, only the colours of the first four will be displayed a dashed border around the annotated characters.  --- ## Open the Text Classification Studio Ensure you uploaded the JSON file as recommended. Learn how to [upload a file](https://docs.dataloop.ai/docs/text-json-format#input-json-format). 1. In the Dataset, select the JSON file. 2. Right-click and select the **Open with** -> **Text Classification Studio** from the list. The file will be opened in the text classification studio. --- ## View Text Blocks Horizontally By default, the text studio does not display text blocks (Shebang Items or Elements) Horizontally. To enable the Horizontal view:  1. Open the **Recipes** -> **Instructions** tab -> **Text Settings**. 2. ☑️ Enable the **Display text blocks horizontally** option. The Horizontal view is available only when working with JSON files. Shebang Item A shebang item is a discrete unit of content within a Shebang file. In text-classification projects, this typically means, a single text block or entry to be classified (e.g., a sentence, paragraph, or document fragment). **Enabled** ☑️: **Display text blocks horizontally** option shown as below:  **Disabled** ⬜: **Display text blocks horizontally** option shown as below:  --- ## Using the Text Tool Create annotations using the Text annotation tool. Enable Formatted Text for Annotating By default, the text studio does not allow you to annotate formatted texts like **Bold**, *Italics*, etc. To enable it, open the Recipes -> **Instructions** tab -> **Text Settings**: enable the **Allow annotating formatted text** option. 1. [Open](/docs/text-studio-v2#open-text-classification-studio) the Text classification studio. 2. Select the label from the [Label Picker](/docs/text-studio-v2#label-picker). 3. Select the Text tool (the pencil icon) from the annotation tools. 4. Double-click on text or click & drag. The selected text part is highlighted with the selected label color. 5. Use the **Selection** tool from the annotation tools to perform the following options: 1. Setting the annotation object ID. 2. Deleting the annotation. --- ## Using the Classification Tool The Classification tool allows you to assign a label class to an entire text item. The annotation is saved in the item's metadata at the item level.  1. [Open](/docs/text-studio-v2#open-text-classification-studio) the Text classification studio. 2. Click on the **Classification** tool from the Annotation Tools. 3. Select the label from the [Label Picker](/docs/text-studio-v2#label-picker). The newly created annotation can be seen in the annotation list on the right side of the screen and as a label chip in the above the text canvas. #### Auto Next Item The **Auto next item on a single classification** checkbox appears when the Classification tool is selected. When the task requires only a single label per text, checking this option will automatically save the annotation and load the next item as soon as a label is selected. --- ## Paragraph Delimiter A **paragraph delimiter** is a character or symbol you define to control **how text is split** into segments (paragraphs) for annotation purposes. It supports only **text** files. This feature lets you choose **whether you want to annotate entire sections (paragraphs)** or break the content into **smaller units like individual words** or **lines**, based on where the delimiter appears in the text. The paragraph delimiter can be any character, including the space bar or **Enter** key. ### Purpose - Helps structure the text visually and logically for annotation. - Controls the **annotation granularity** — you can mark: - Each word (if you use **space** as the delimiter) - Each line (if you use **Enter/newline** as the delimiter) - Custom blocks (using a specific character like `|`, `;`, etc.) For example: - Delimiter = space → the system treats **each word** as a paragraph. - Delimiter = newline/Enter → the system treats **each line or sentence** as a paragraph. - Delimiter = empty → the system **does not break** the text at all; it's treated as a **single block**. ### Set the Paragraph Delimiter By default, the paragraph delimiter is empty. To set the paragraph delimiter, follow these steps: 1. Open the Recipe page. 2. Select the **Instructions** tab. 3. In the **Global Settings**, find the **Paragraph Delimiter**.  1. Click on the field next to the paragraph delimiter, and set your desired delimiter: - You can **press the space bar** to use a space as the delimiter. - You can **press Enter** to use a line break (newline) as the delimiter. - You can also **type a custom character**, such as `|`, `,`, `#`, or any other. 2. Save the changes you made to the recipe by clicking the **Save** icon. Once a paragraph delimiter is set, each annotation you make will apply to the entire delimited section. To **clear** the delimiter setting, click the X button next to the paragraph delimiter field. **Note**: When the paragraph delimiter is set to **None**, the text will be presented as one paragraph. If you wish to have the text in its **original paragraph structure**, check the box “use pre-wrap spaces in text files.” --- ## Export Text Annotations You can [export](https://docs.dataloop.ai/docs/annotation-studio-basics#export-annotations-from-an-item) the text annotations in the [JSON](https://docs.dataloop.ai/docs/nlp-json-format) format.