Manage Annotation Projects

In the Encord platform, select Projects under Annotate.
Select the Project you want to Manage.

The dashboard is split into the following tabs:

Project Overview: High-level view of labeling and productivity statistics.
Explore: Explore the distribution of instances and labels across data assets in the project.
Queue: Shows all tasks in the Project by Workflow stage.
Workflow: Graphically displays the path tasks follow through the Project Workflow.
Labels & Export: For managing all the Project’s labels, including exporting labels.
Analytics: Detailed Project analytics.
Settings: Manage your Project Settings, including copying Projects, managing Project tags, customizing editor layouts, and deleting Projects.

Tab Visibility by Role

The Analytics and Queue tabs display different information based on the user’s role. For more details, refer to the Analytics dashboard documentation.

The Labels & Export tab for admins is called the Labels tab for Team Managers.

Tab	Annotator	Reviewer	Annotator + Reviewer	Team Manager	Admin
Summary	❌	❌	❌	✅	✅
Explore	❌	❌	❌	✅	✅
Queue	Annotate tab only	Review tab only	Annotate + Review tabs only	✅	✅
Workflow	❌	❌	❌	View only	✅
Labels & Export	❌	❌	❌	View labels only	✅
Performance	Personal performance	Personal performance	Personal performance	Team Performance	Team performance
Models	❌	❌	❌	View only	✅
Settings	❌	❌	❌	Add users (except Admins)	✅ All settings and user management

Update Project Status

Contact support for access to this feature.

Admins and Team Managers can change the status of a Project to any of the following:

Not started
In progress
Paused
Completed
Cancelled
Archived

Updating the Project status changes the Project icon accordingly.

When the Project status is changed to either Paused, Completed, or Cancelled then Annotators, Reviewers, and Annotator + Reviewers are prevented from opening tasks, and the Initiate button is grayed out. Admins and Team Managers are able to annotate and review tasks as usual, regardless of the Project status.

Tasks can still be opened using back door access. For example if an Admin shares a specific URL of a task with an Annotator, Reviewer, or Annotator + Reviewer.

Project Overview

The Project Overview dashboard has the following components that provide an overview of the Project.

Component	Description
Instance labels created	Displays the total number of labels (object labels and classifications), in the Project, that have been submitted for review. Labels on Text and HTML files are not counted.
Time spent	Displays the total amount of time, in the Project, spent by users in the Label Editor performing tasks. For example, time spent annotating, editing, and reviewing tasks, and making and resolving issues.
Open issues	Displays the total number of open issues in the Project.
Project task status	Displays the number of tasks that are in each stage of your Project. The number of stages and their names reflect the choices made during workflow project selection/creation.

Explore tab

The Explore tab is a legacy feature and will be discontinued.

The Explore tab is only visible to project Admins and Team Managers.

The Explore tab helps you understand how project annotations are distributed among data assets, at both an instance and label level. It allows a deeper exploration through attributes on objects, as well as frame-level classifications.

Instance statistics: Class distribution across data assets in the given project.
Label statistics: Label distributions within data assets, objects and classifications.

Instance statistics This section provides the total count of all instances across the datasets in your project.

Project total: Shows total instances (both objects and classifications) across the project by default. To get instance statistics for individual data files, click the drop-down to select a data file.
Select class: Shows the total instances for a particular class. This is a summary of how a given class is distributed across your project’s data assets. The pie chart segments show a breakdown of how that class is split across the data assets.
Display timestamps: Flip the toggle to switch between frame numbers and timestamps for the labels.

Label statistics This is a summary of how your labels are distributed across the project. The pie chart shows a breakdown of how many labels there are for a given class.

Project total: Shows the total number of labels across different datasets in the project. To get label stats for individual data files, click the drop-down to select a data file.
Objects: Click on the pie chart segment of a class to see the total number of labels and its attributes (sometimes called nested attributes) if available for that class.
Classifications: Shows the global classification at project or individual video level. For example, location, time of day, etc.

Task Queue & Workflow

Use the Queue tab to assign, prioritize, and manage tasks, as well as to start labeling and reviewing for all users associated with a Project.

The Queue tab’s layout adapts based on user permissions.

Queue (Admin, Team Manager)

Queue (Annotators)

Queue (Reviewers)

Workflow tab:

The Workflow tab is only visible to project Admins and Team Managers.

The Workflow tab lets you view and edit the Project’s Workflow. To begin editing the Workflow, click the Edit button on the canvas.

Labels & Export

The Labels tab is only visible to project Admins and Team Managers.

The Labels tab is your gateway to auditing and exporting labels created in your project.

Access to each pane depends on the user’s role.

Role	Activity	Queue	Data	Instances
Annotator	❌	✅	❌	❌
Reviewer	❌	✅	❌	❌
Annotator + Reviewer	❌	✅	❌	❌
Team Manager	✅	✅	✅	✅
Admin	✅	✅	✅	✅

The labels dashboard features the following tabs:

Data: A complete overview of all tasks in the project, with the option to export your labels on a per-task basis.
Label Instances: The Label Instances tab lets you use the unique instance identifier to search the project for a specific instance, and jump directly into the editor to confirm the status of an annotation visually.

Data tab

The Data tab provides a complete overview of all tasks in the project, and lets you see which workflow stage each task is in.

Export labels

Click Export while in a Project. The Export labels dialog appears.
Specify the following:
- Format: Specify the format to export the labels (JSON or COCO).
- Stage: Specify the Workflow stage to export the labels from.
- Generate signed URLs: Specify whether to generate signed URLs for the data units that have labels.
Enabling this option can significantly increase export times.
- Save as new version: Specify to version the labels.
- Labels to include: Specify the labels to include. You can export all labels or select specific object or classification labels to export.
Click Export. A Labels export in progress toast message appears.

Legacy

Select the data units in the Data tab you want to export labels for and click the Export and save button highlighted in the screenshot below to export labels. See our documentation on exporting labels for more information.

Save Label Version

Click Export while in a Project. The Export labels dialog appears.
Specify the following:
- Format: Specify the format to export the labels (JSON or COCO).
- Stage: Specify the Workflow stage to export the labels from.
- Generate signed URLs: Specify whether to generate signed URLs for the data units that have labels.
Enabling this option can significantly increase export times.
- Save as new version: Specify to version the labels.
  - Provide a meaningful name for the label version.
- Labels to include: Specify the labels to include. You can export all labels or select specific object or classification labels to export.
Click Export. A Labels export in progress toast message appears.
Go to Labels & Export > Versions. The version of your labels appears in the Versions table.

Legacy

Select the data units you’d like to save label version for and click the Save new version button highlighted in the screenshot below. It will be listed in the Saved versions tab.

A new label version is saved each time you export labels.

Label versioning allows you to keep track of your label history over time by providing a snapshot of labels at a point in time. Label versions can be exported and analyzed to track annotation performance over time.

Label Instances

The Label Instances tab allows Administrators and Team Managers to search for specific instances within the data. An annotation instance refers to a unique occurrence of an ontology class in a data asset (e.g., ‘Person (0)’ for the first instance of a ‘Person’). Instances span multiple frames of a data asset, representing the same object. Use this tab to locate specific objects or classifications by their Identifier.

Instance identifiers are unique within a project and can be found in several ways:

In the Label Editor: Click on an instance, then select Copy identifier from the instance action menu.
In Exported Labels: Look for objectHash or classificationHash in the exported data.
Using the SDK: Specify your own objectHash or classificationHash during label uploads.

Once you have an identifier, use the Search instance interface to filter and locate the specific instance. This is especially useful for visually confirming annotations linked to an identifier. After finding your instance, click View in the Actions column to jump directly to the first annotation of that instance in the dataset.

Saved Versions

The Saved versions tab displays information for versions of your labels. The Actions column lets you:

Export label versions by clicking the Download version icon in the Actions column. For format of exported labels has the same structure as outlined in the export documentation.
Delete label versions by clicking the Delete version icon in the Actions column.

Analytics

The Analytics tab of your Project shows event-based analytics for your Project’s tasks, labels, and users. The Analytics tab has the following views:

Tasks: View analytics on specific tasks in your Project.
Labels: View analytics of labels in your Project.
Collaborators: View collaborator performance in your Project.
Issues: View analytics relating to issues in your Project.

The analytics available on the Analytics dashboard vary based on user roles:

Admins and Team Managers have access to the Tasks, Labels, and Collaborators views, offering a comprehensive overview of team performance.
Annotators, Reviewers, and Annotator + Reviewer roles can only view the Task Actions, Time Spent, and Label Actions tables, limited to their individual contributions.

Actions performed in the Label Editor or using the SDK are only tracked on the Analytics dashboard if they the tasks are actioned (submitted/rejected/approved).

Project Analytics have the following filters:

Filter	Description
Collaborators	Filter by specific Project collaborators.
Datasets	Filter tasks based on the dataset they belong to.
File name includes	Filter by file name. Regex is supported, allowing filtering by prefix or infix in the file title.
Event source	Filter by the source of the event. Either SDK or UI.
Workflow stage	Filter tasks based on their current stage in the Workflow.
Class	Filter by Ontology class.

Tasks

The Tasks tab of the Analytics dashboard provides a detailed overview of task throughput, stage efficiency, and task timers. It can help answer questions such as:

How productive was each collaborator in terms of labeling and reviewing tasks over the last week?
- By filtering the data by Collaborators and Date time range, you can see how many tasks each team member worked on and how much time they spent on labeling and reviewing.
Which Dataset has the most labels added, edited, or deleted in a given Workflow stage?
- You can filter by Datasets and Workflow stage to see which Dataset is being worked on the most and how many labels are being modified at each stage of the process.

The following charts are visible in the Tasks view:

Chart	Description
Task actions	Displays the number of annotation tasks submitted, skipped, review tasks approved, and review tasks rejected over a selected date range.
Time spent	Shows the total time spent actively working in the Label Editor, providing insights into productivity.
Task performance	Shows the actions taken for all tasks in the Project.

The Task performance table includes the following columns:

File name: The name of the file associated with the task.
Data type: The type of file used in the task (example: image, video, DICOM).
Dataset: The Dataset from which the task originates.
Total time: The total time spent on the task.
Total created labels: The number of labels created in the task.
Total edited labels: The number of labels that were modified in the task.
Total deleted labels: The number of labels that were removed in the task.
Time spent - The amount of time spent in a specific Workflow stage.
Collaborators - The users who contributed to a specific Workflow stage.
Created labels - The number of labels created in a specific Workflow stage.
Edited labels - The number of labels modified in a specific Workflow stage. In review stages, this refers to Edit Review.
Deleted labels - The number of labels removed in a specific Workflow stage.

Labels

Label analytics are not supported for Text and Audio modalities.

The Labels tab in the Analytics dashboard provides a detailed overview of your team’s labeling, reviewing, and task productivity, including time spent. It can help answer questions such as:

How many labels were submitted, approved, or rejected by the team over a given period?
- Use the Label actions chart and apply the Date time range filter to view the total number of labels submitted, approved, or rejected within the selected time frame.
What actions have been taken for specific objects and classifications in the Ontology?
- Refer to the Objects and classifications actions chart and expand classifications within the Ontology column to see detailed statistics for each classification answer.
How does the team’s productivity in labeling compare across different objects or classifications? Do certain objects take more time to label than others?
- Analyze the Created, Approved, and Rejected columns in the Objects and classifications actions table to identify objects or classifications that might require additional review or clarification using their Rejection rate.
- Compare the average time spent per object or classification by utilizing time-tracking metrics alongside these productivity statistics.

All charts allow you to view instance labels or frame labels by selecting the appropriate option from the dropdown next to the filter button.

Chart	Description
Label actions	Displays the number of labels submitted, approved, or rejected.
Objects and classifications actions	Shows the actions taken for all objects and classifications in the Ontology.

The Objects and classifications actions table includes the following columns:

Ontology: Represents the Ontology class, encompassing both objects and classifications. For classifications, you can expand to view statistics for each classification answer.
Created: Displays the total number of instances created for this Ontology class. Each instance is counted only once, ensuring that resubmissions of the same label are not double-counted.
Approved: Displays the total number of instances of this Ontology class that have been approved. Approvals are counted multiple times if a label is approved in multiple review stages or if the task is reopened and reviewed again. Use stage-specific filters to see approvals per review stage.
Rejected: Displays the number of instances of this Ontology class that have been rejected. Rejections are double-counted if a label is rejected in multiple review stages, rejected again within the same stage, or if the task is reopened and rejected again. Use stage-specific filters to see rejections per review stage.
Rejection Rate: Calculates the rejection rate percentage of the given Ontology class by dividing the number of rejected labels by the total number of reviewed labels.

Collaborators

The Collaborators in the Analytics dashboard provides a detailed view of time spent annotating and reviewing by Project collaborators. It can help answer questions such as:

How much time did each collaborator spend on annotation / review tasks?
- Use the Time spent chart to see the time distribution for each collaborator across annotation and review tasks. The Annotators and Reviewers tables, which provide total and average times for each collaborator.
Which collaborator spent the most time annotating or reviewing tasks in the Project?
- Analyze the Time spent chart to identify the collaborator with the highest time allocation.

Chart	Description
Time spent	Displays the distribution of time spent per collaborator per day
Annotators	Table view of all relevant task/label actions and timers for each collaborator in the Annotation stages
Reviewers	Table view of all relevant task/label actions and timers for each collaborator in the Review stages

Labels refer to objects and classifications.
Approve actions are are double counted if there are multiple review stages.
Review actions are double counted if multiple review stages are present or tasks get rejected again in the same review stage.

Both tables and all CSV exports are filter-sensitive; they only display information within the selected filter conditions.

The Annotators and Reviewers table columns vary depending on whether the Instance labels or Frame labels view is selected. They include the following columns.

Instance Labels

Frame Labels

You can choose which columns should be displayed and included in the CSV export using the Columns selector.

Issues

The Issues tab in the Analytics dashboard provides a detailed view of all issues created in the Project.

Chart	Description
Issue actions	Shows the number of issues created, resolved, and opened.
Issue tag occurrence	Shows the count of all issue tags used within the chosen timeframe.
Issue tag occurrence by class	Shows the actions taken for all objects and classifications in the Ontology.

The Issue actions chart shows the following:

Total issues created: The total number of issues created.
Total issues resolved: The number of issues marked as resolved.
Total issues reopened: The number of issues that were reopened.

Example - How to Understand Issue Analytics: If your Issue actions chart shows:

Total issues created = 19
Total issues resolved = 20
Total issues reopened = 2

This means that:

19 issues were created.
All 19 issues were resolved.
2 resolved issues were reopened. (This includes manually reopening an issue and re-rejections of labels)
1 of the reopened issues was resolved.
There is one remaining open issue.

Join Projects in your Org

Organization Admins can search for and join any Projects that exist within the Organization. This includes Projects that contain no collaborators.

Navigate to Projects under the Annotate heading in the Encord platform.
Select the All Encord projects tab.
Find the Project you want to join.
Click Join project to join the Project.

When an Organization Admin joins a Project, they are automatically assigned the Admin user role for that Project.

Projects can be filtered by Project owner or Project tags.

See all Projects you belong to by clicking the Filter by project owner search bar, and selecting My projects only.

Get Started

General

Index

Annotate

Active

Other