> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encord.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Reviewer Label Editor Basics
To ensure seamless data loading in Encord, allowlist [https://app.encord.com/](https://app.encord.com/) or [https://app.us.encord.com/](https://app.us.encord.com/) in any 3rd party VPNs, firewalls, or URL isolators. This helps to prevent potential issues with opening your data in Encord.
This documentation provides a comprehensive guide to using the Label Editor for review, covering its components, features, and the display of various elements.
## Review Mode
### Introductory Videos
The following video goes through the basics of reviewing images in the Label Editor.
The following video goes through the basics of reviewing videos in the Label Editor.
As a reviewer, your label editor workspace will look as below. Learn how to use the features in the components illustrated below.
Use the show-hide labels buttons, workspace settings, and the drag and select in the workspace to speed up your approved label selection and review process.
***
### Review Mode Components
* **A**. [Editor menu](#editor-menu)
* **B**. [Single label review toggle](#single-label-review)
* **C**. [Quick toolbar](#quick-toolbar)
* **D**. [Pending reviews pane](#pending-reviews-pane)
* **E**. [Completed reviews pane](#completed-reviews-pane)
* **F**. [Reject and Approve buttons](#reject-and-approve-buttons)
* **G**. [Editor timeline (for videos and image sequences only)](/platform-documentation/Annotate/annotate-label-editor/annotate-videos#editor-timeline)
* **H**. [Editor header](#editor-header)
* **I**. [Edit labels during review](#edit-labels-during-review)
* **J**. [Approve and Reject all in frame buttons](#approve-and-reject-all-in-frame-buttons)
***
### Single Label Review
The normal review mode displays all labels simultaneously, allowing you to quickly approve or reject many labels in bulk actions. Alternately, enter the *Single label review* mode by toggling the switch at the top left. The single label review mode automatically highlights the selected instance, and hides all other objects. This allows you to carefully review one instance at a time including their attributes, and quickly iterate through the different instances using the *Up* and *Down* keys on your keyboard or by clicking the appropriate buttons in the UI.
The *Single label review* feature can also be considered "turbo review mode," analogous to the "turbo attribute mode" in annotation mode, because it allows the reviewer to quickly step through and review instance attributes. "Turbo attribute mode" in the editor settings can be disabled while in review mode.
**Single Label Review Settings**
The default zoom level for single label review can be adjusted to suit your needs.
1. Open the [editor settings](#editor-settings-menu) by clicking in the [editor header](#editor-header).
2. In the *General settings* section adjust the *Set the default zoom level for single label view* value highlighted in the screenshot below. The settings will be applied for the next selected label.
* Initially, the default is set to 60%
* 20% corresponds to no zoom. It's the magnification at which the image or frame is displayed in the Label Editor.
* To zoom in, increase the percentage value.
* To zoom out, decrease the percentage value. The minimum value is 1%.
***
### Edit Labels During Review
It is sometimes faster, more convenient, and less error-prone to have reviewers make edits to annotations, instead of outright rejecting them. Rejection requires the return of the entire set of labels to the annotator.
*Edit review* allows reviewers to make changes to labels, remove labels, and add new labels. Approved or rejected labels cannot be edited. Only *Pending* labels can be edited by reviewers. New labels made by editors are automatically approved, and cannot be changed once they have been saved. Once all labels have been approved the task moves to the *Complete* stage.
We recommend enabling [*Strict review*](/platform-documentation/Annotate/annotate-projects/annotate-workflows-and-templates#strict-review) on Review blocks when configuring Workflows. *Strict review* allows reviewers to revert approved labels back to *Pending*, giving reviewers the option to make changes to new labels drawn while editing labels.
**To edit labels in review mode:**
1. Click the **Edit labels** button.
2. Add or remove labels, or edit existing labels as necessary using the same interface annotators use to create labels.
3. Click the **Save and return to review** button to save your edits and return to review mode.
The **Save and return to review** button replaces the **Save** and **Cancel** buttons used in earlier versions of this feature.
* There is no way to edit Classifications.
* Labels created during *Edit review* are not added to the Review stage and can not be seen in the Label Editor.
***
### Pending Reviews Pane
All labels for review for a particular data asset assigned to the reviewer are automatically loaded into then *Pending reviews* pane. The labels are grouped by Ontology class.
You can search for specific classes and labels by clicking the **Search** button (magnifying glass icon) in the header within both the **Pending reviews** and **Completed reviews** panes to quickly locate the items you need to review.
***
### Completed Reviews Pane
Completed reviews are displayed in the *Completed reviews* pane. You can click on specific objects to highlight them. Labels can be selected and then approved or rejected for a given instance or in bulk using the **Reject** and **Approve** buttons or the matching hotkeys, b for reject and n for approve. Approved labels appear in a green background and rejected labels appear in red.
You can search for specific classes and labels by clicking the **Search** button (magnifying glass icon) in the header within both the **Pending reviews** and **Completed reviews** panes to quickly locate the items you need to review.
***
### Approve and Reject All In Frame Buttons
The **Approve all in frame** and **Reject all in frame** buttons take the named action without having to select a particular instance or set of instances. This speeds up workflows, particularly in images, where you can judge whether all instances are correct or not by looking at an individual frame.
The **Approve all in frame** and **Reject all in frame** buttons apply to all instances present in a frame, rather than labels. This means that all instances with labels in the current frame will have all of their labels approved or rejected.
The **Approve all in frame** and **Reject all in frame** buttons can be hidden in the [general settings](#general-settings).
***
### Reject and Approve Buttons
To reject/approve multiple object instances across frames, select the instances, and then click the **Reject** or **Approve** button, as appropriate. Alternately, you may press b for reject and n for approve.
***
### Review Status Color Mode
When **Label color mode (review)** is set to **By review status** in the editor settings, labels are recolored to reflect their current review state:
* **Pending** — orange
* **Approved** — green
* **Rejected** — red
Labels that you approve or reject during the current session fade to the opacity level configured by the **Reviewed label opacity** setting, making it easier to track your progress through a dense set of labels.
**By review status** color mode and **Reviewed label opacity** now apply to all 3D label types in point-cloud review tasks, including cuboids, spheres, polylines, and keypoints/points. This brings 3D review workflows to visual parity with 2D review.
The opacity fade applies only to filled shapes (cuboids and spheres). Polylines and keypoints/points are recolored by review status but do not fade. For full details on 3D-specific behavior, see the [point cloud editor documentation](/platform-documentation/Annotate/annotate-label-editor/annotate-pcd).
***
### Change Review Judgement
Reviewed instances can be reverted to [*pending*](/platform-documentation/Annotate/annotate-label-editor#pending-reviews-pane). Reverting a review allows reviewers to make adjustments to one or more instances after making their initial review.
1. Revert labels to *pending* :
* Revert an approved task to *pending* by clicking the green tick icon next to the instance.
* Revert a rejected task to *pending* by clicking the red cross icon next to the instance.
2. Once the reviewer completes their review, they need to click the **Approve task** or **Reject task** to finalize the review.
***
## Controls Common To Both Modes
### Editor Timeline
The Editor timeline visualizes when objects and instances appear throughout videos, scenes, and audio files. The cursor tracks playback in real time, always reflecting the current frame. The timeline is shown by default and can be resized or hidden by dragging it up or down.
***
### Editor Menu
Open the editor menu by clicking the menu icon in the top left corner of the Label Editor.
The editor menu contains the following controls:
* **Return to Project** - Returns the user to the Project navigation.
* **Save changes** - Saves the current state of all labels.
* **View** - Allows users to change what information is displayed next to all labels.
* [**Bulk label operations**](/platform-documentation/Annotate/annotate-label-editor/annotate-label-editor-annotate#bulk-label-operations) (annotation mode only) - Allows the user to perform actions on many labels at once.
* [**Automated labeling**](/platform-documentation/Annotate/annotate-label-editor/annotate-label-editor-annotate#automated-labeling) (annotation mode only) - Lets the user choose between several automated labeling techniques.
* **Dark mode** - Toggle dark mode on and off.
* **Keyboard shortcuts** - Displays a full list of keyboard shortcuts.
* [**Editor settings**](/platform-documentation/Annotate/annotate-label-editor/annotate-label-editor-settings-shortcuts) - Opens the Editor settings.
### Editor Header
The Editor header at the top-right of the navigation bar contains buttons and menu items to perform labeling activities as well as manage general app settings and notifications.
| **Icon** | **Name** | **Description** |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| Help | Links to the: quick start guide, documentation, learning hub, and Encord support team. |
| 
| Notifications | Shows the current status and history of actions taken in the application. This includes uploading datasets, training models, and exporting labels. |
| 
| Share | Copies the URL of the asset currently being labeled or reviewed. |
| 
| Save labels | Manually saves labels on the Encord server. |
| 
| Label Editor settings | Settings controlling your labeling and reviewing experience. |
| 
| Issues | Shows any issues and comments for the current task, such as any objects or classifications marked as *Required*, or comments added by other users. |
***
### Quick Toolbar
A toolbar with handy tools to:
* [Rotate the label editor](#rotate-the-label-editor).
* Adjust filters; contrast, brightness, gamma, [pixelated scaling](#pixelated-scaling), and [grayscaling](#grayscale-filter).
* Remove polygon vertices.
* [Add comments or issues to a frame or image](/platform-documentation/Annotate/annotate-label-editor/annotate-label-editor-annotate#issues-and-comments).
* Quickly center an image.
* Zoom in and out.
Remove polygon vertices (the scissors tool) is currently not available in review or review-edit mode.
Click the zoom icon again to disable zoom.
***
### Rotate the Label Editor
Click the *Rotate toolbar* icon on the [quick toolbar](#quick-toolbar) to bring up a pop-up that enables you to rotate the label editor by using the slider, as shown below.
Click the *Rotate 90 degrees* icon to rotate the editor in increments of 90 degrees.
***
### Pixelated Scaling
The *Pixelated scaling* feature enhances the visibility of individual pixels in an image or frame by disabling the browser's automatic edge smoothing. This increased pixel clarity aids annotators in creating precise, pixel-perfect annotations, thereby improving their annotation accuracy, especially when zooming into an image.
| *Pixelated Scaling* turned on | *Pixelated Scaling* turned off |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| 
| 
|
Enable *Pixelated scaling* by selecting the *Adjust filters* icon (
)in the [Quick toolbar](#quick-toolbar) and enabling the *Pixelated scaling* checkbox, as shown below.
*Pixelated scaling* is a browser-specific feature. The table below shows which types of files *Pixelated scaling* works for Firefox and Chrome.
| File type | Chrome | Firefox |
| -------------- | ------ | ------- |
| Image | ✅ | ✅ |
| Image group | ✅ | ✅ |
| Video | ❌ | ✅ |
| Image sequence | ❌ | ✅ |
***
### Grayscale Filter
The *Grayscale filter* feature enhances the visibility across an image or frame by applying an RGB grayscale to the image/frame. The filter applies across the pixels of an image/frame using the value for Red, Green, or Blue as a base then converting to grayscale.
You can use the Grayscale filter on images, videos, and DICOM (DICOM and NIfTi) series.
**Grayscale Image/Frame**
**Grayscale DICOM/NIfTi**
### Media Navigation Controls
The video frame slider lets you quickly scroll through frames in a video asset. Below the frame slider are a range of controls to let you play, skip and navigate through media. Notice that the navigation controls are not displayed in single images files, as well as any media with only 1 frame.
**Icon descriptions**:
The *Time* and *Frame rate* information for each frame is displayed in the far lower right corner.
***
### Issues and Comments
* Add [Issue Tags](/platform-documentation/Annotate/annotate-projects/annotate-project-settings#issue-tags) to a Project to flexibly categorize and group your issues.
* Use the [Issues tab of your Project Analytics](/platform-documentation/Annotate/annotate-projects/annotate-project-analytics#issues) to learn about issues in your Project.
A complete walkthrough of all things Issues and Comments related can be found [here](/end-to-end/Features/issues-e2e).
Issues can be added to annotation and review tasks to communicate with other users. All issues contain comment threads relating to the entire task or specific sections of the task. A small notification badge on the *Issues* icon displays the number of unresolved issues in a task.
**Types of Issues**:
* **Label rejection**: Created when a reviewer rejects labels. The reviewer is prompted to provide a reason for the rejection in the form of a comment. If all instances in a frame or image are rejected, a separate rejection issue is created for each label. Labels with rejection issues display a red Issues icon next to the instance name, which turns green once the issue is resolved.
* **File**: Apply to the entire file and can be created at any stage within the Label Editor.
* **Pinned**: Apply to a specific part of the file or frame and can be created at any stage within the Label Editor. Red *Pin* icons indicate unresolved issues and remain red until they are marked as resolved.
* **Frame**: Apply to a specific frame and can be created at any stage within the Label Editor. Frame issues can only be created when multiple frames are present; such as in a video, image sequence, or DICOM volume.
* **Frame range**: Apply to a range of frames and can be created at any stage within the Label Editor. Frame range issues can only be created when multiple frames are present; such as in a video, image sequence, or DICOM volume. Frame range issues can only be [created during label validation](/platform-documentation/Validation/active-basics/active-comments).
* **Task requirement**: Are created for each object or classification [marked *Required* in the Ontology](/platform-documentation/Annotate/annotate-ontologies/annotate-ontologies#required-attributes). The issue is resolved when the required object or classification is applied. Task requirement issues are the only issues visible in a Consensus annotate stage.
- Selecting an issue card highlights the associated label. If a frame number is present, clicking it navigates directly to the corresponding frame.
- Issue threads can be filtered by *Resolved* and *Unresolved* issues.
**To Create a new Issue**:
Issues cannot be created in a Consensus annotate stage.
1. Open the *Issues* pane by clicking the *Issues* icon.
2. Click the *New issue* icon (or keyboard shortcut Ctrl+N).
3. Click the *Apply to* dropdown to select the type of issue you want to create.
4. Select any [Issue Tags](/platform-documentation/General/general-workspace-settings#issue-tags) you want to apply to the issue.
5. Add a comment to the issue.
6. If you selected 'Pin on canvas' in Step 3, click the desired location on the canvas.
7. Click **Create issue**.
**To Resolve an Issue:**
1. Open the *Issues* pane by clicking the *Issues* icon.
2. Click the *tick* to mark a thread as resolved.
Resolved issues remain visible but can be filtered out. All users can resolve issues.
**To Delete an Issue Thread:**
Deleted threads are NOT counted in the [Issues analytics](/platform-documentation/Annotate/annotate-projects/annotate-project-analytics#issues).
1. Open the *Issues* pane by clicking the *Issues* icon.
2. Click the *Ellipsis* icon to show more options.
3. Click **Delete thread**.
Users can only delete issues that they created. **Label rejections cannot be deleted, only resolved**.
**To Reopen an Issue Thread:**
1. Open the *Issues* pane by clicking the *Issues* icon.
2. Click *Reopen* on an issue that was previously resolved.
**Use Cases**:
* **Ask questions**: Annotators and reviewers can ask questions about the task. Admins can use this feedback to improve guidance.
* **Explain task rejection**: Reviewers can provide reasons for rejection, helping annotators avoid repeating mistakes.
* **Track unresolved issues**: Keep a record of open discussions that need follow-up before finalizing annotations.
***
### Editor Lock
The 'Editor lock' is a safety feature we implemented to prevent several people making changes to the same file - annotators labeling, or reviewers reviewing the same data unit.
A warning is triggered in two cases:
1. When you have the same task open in two different tabs or browser windows:
2. When a different user is editing the same task:
