Skip to main content
The Queue tab in an Encord Annotate Project gives you a centralized view of all tasks across every Workflow stage. Use it to assign tasks to annotators and reviewers, set priorities, apply filters, and start labeling or reviewing work — all without leaving the Project dashboard.
Tasks with the same priority are listed oldest first. See Set Task Priority for how the queue is ordered.

Queue Layout by Role

The Queue tab adapts based on the logged-in user’s role.

Queue (Admin, Team Manager)

  • A — The list of Workflow stages shows the number of tasks currently visible to you in each stage. Click a stage to view its task queue.
  • B — Shows the task’s priority number. Tasks are listed in descending order of priority by default.
  • C — Search, sort, and filter the list of data units by Dataset, Assignee, Data Type, Status, or Issue Status.
  • D — Shows the task’s Status (New, Reopened, Skipped). For tasks that have moved through previous stages, an info icon appears next to the status badge. Hover over the icon to see details about the previous stage, including the stage name, who performed the action, and when it occurred.
  • E — Task Actions. Assign or release selected tasks, adjust priority, or move tasks to a different Workflow stage.
  • F — Switch between List and Explorer view.
  • G — Use the Start task button to begin labeling or reviewing a task.
  • H — Click the Initiate button to open a specific task in the Label Editor.
The Queue tab lists tasks in the same order they appear in the Label Editor.

Queue (Annotator)

Annotators only see tasks in the Annotate stage that are assigned to them. They cannot view tasks in the Review stage or tasks assigned to other users.

Queue (Reviewer)

Reviewers only see tasks in the Review stage that are assigned to them. They cannot view tasks in the Annotate stage or tasks assigned to other users.

Queue (Annotator + Reviewer)

Users with the Annotator + Reviewer role can see both the Annotate and Review tabs in the Queue. They are limited to tasks assigned to them in each respective stage.

Paused Agent Indicator

When any Agent stage in your Workflow is paused, the Queue tab displays an information icon next to its name. This indicator alerts you that tasks in paused Agent stages do not execute automatically until the Agents are unpaused.
Click the information icon to see which Agent stages are paused and need attention.

Agent Stages

When viewing an Agent stage, the Queue displays additional controls and status information for Workflow agents. Agent Status Banner For Agent stages, a status banner appears above the task list showing the agent name and icon (click to view detailed agent configuration), a status indicator showing whether the agent is Live (green) or Paused (orange), and control buttons that Admins and Team Managers can use to pause/resume agents or view agent settings. Agent Controls
Only Workspace and Project Admins and Team Managers can control agent execution.
Use manual execution when testing agent configurations or troubleshooting specific data units before resuming live processing.
Agent Execution Status For Projects using Agents in their Workflow, tasks display execution status indicators showing the current state of automated processing. In Grid view, hover over or focus a failure indicator to view the error and retry details returned by the Agent. Run or Retry Multiple Tasks In a paused Agent stage, select one or more tasks in the Queue, click Actions, and select Run on agent. Encord starts pending tasks and retries failed or timed-out tasks together. Running and completed tasks are skipped.
The Retry failed button is only available for Agents configured in the Agent catalog and only appears when you have selected tasks that failed or timed out.
Agent execution controls are available only to Workspace and Project Admins and Team Managers in queues they can manage. Run on agent is disabled when the selection contains no eligible tasks or a selected request is in progress.
Moving Agent Tasks When moving agent tasks to the next stage, the system skips tasks that are currently running or dispatched (they remain in the current stage), only moving tasks that are not actively being processed. A confirmation dialog will show how many tasks are moved and how many are skipped.
Tasks that are currently running or dispatched cannot be moved and remain in their current stage until execution completes.

Queue View Options

The Queue offers different view modes to help you work with tasks more effectively:
  • List view — The default tabular view showing tasks in a structured list format
  • Grid view — A visual grid layout for browsing tasks and labels
  • Visual Queue — An enhanced visual interface for task management (when available)
Use the view switcher in the top-right corner of the Queue to change between available options. In Grid view, each card shows a square task thumbnail with its status, priority, details, and available task controls. Use Initiate or View to open the task, or open the Task actions (⋯) menu to manage it when your role permits. If you can manage tasks, click a thumbnail to select the task. Double-click a thumbnail, or hover over it and click Open preview, to inspect the media without changing your selection. The expanded preview shows the data unit title, status, Dataset, assignee, and Workflow stage. When your role and the workflow stage permit, you can select the task, assign it, change its priority, and open the Task actions menu without closing the preview. You can also use the available primary task action from the preview. Use the left and right arrow buttons or keys to move through tasks, including tasks on the previous or next Queue page. For a Data Group, the arrows move through its items and then continue to the adjacent task; use Shift with an arrow key to jump directly to the adjacent task. Select an item from the thumbnail strip to open it in the preview. Thumbnails are cropped to fill their cards by default. To show the whole image or frame instead, open Display, select General, and turn off Crop thumbnails to fill. Task thumbnails display image labels, including keypoints and the individual points in skeleton labels, when Display all labels is enabled. This setting is enabled by default; to change it, open Display, select Label, and toggle Display all labels.
Skeleton connections are not shown in Grid view or the expanded image preview. All skeleton points are displayed as solid dots, regardless of their visibility or occlusion state.
Visual Queue availability varies based on your Project settings and enabled features. Some Projects may only show the List and Grid view options.

Filters and Sorting

Filters Click Assigned to me (the person icon beside Filter) to show only tasks assigned to you. Click it again to clear the Assignee filter. Selecting this shortcut replaces any existing Assignee selection. It is available in stages that support the Assignee filter when you are an assignable Project member. Users who can view every task can filter by any Project collaborator or Unassigned. Other users can filter by themselves or Unassigned, matching the tasks available in their queue. Start and External stages do not support the Assignee filter. Review, Complete, Archive, and Skip stages include a Last actioned column identifying who most recently processed each task. Sort by Click Sort by next to the filter button to sort Start, External, Annotate, and Review stage queues by priority, creation time, or title. In Complete, Archive, and Skip stages, you can sort by the time the task arrived in that stage or by title. You can reverse the order for any sort option. Start, External, Annotate, and Review stages sort by descending task priority by default. Complete, Archive, and Skip stages show the most recently arrived tasks first by default. In Parallelization queues, Sort by is hidden because priority is the only available sort field. Click the Priority column header to switch between ascending and descending priority.
Object count filtering and sorting are available based on your organization’s feature access.
Use the keyboard shortcut S to open the sort dropdown, or Ctrl + O to quickly toggle between ascending and descending order.

Task Status

The task Status indicates what actions have previously been taken on a task. For tasks that have moved through previous Workflow stages, an info icon appears next to the status badge. Hover over the icon to see details about the previous stage, including the stage name, who performed the action, and when it occurred.
The previous stage information helps you track task history and understand the workflow progression for each data unit.

Review Status

In Review stages, the queue includes a Review Status column that shows each task’s current status in the review lifecycle. You can sort by this column and filter on it using the Review Status filter to focus on tasks at a particular point in review.
The Review Status column and filter appear only in Review stages. Review tasks reuse the same lifecycle statuses as annotation tasks while they are in the queue.

Task Actions

Per-Row Task Actions

Every task row in the Queue has a three-dot (⋯) menu that gives you quick access to actions for that individual task without selecting it first.
Assign, Release, Change priority, and Move to stage are only available to Workspace and Project Admins and Team Managers. In Projects other than TMS3, View, Activity log, and API details are available to all users who can see the queue row. In TMS3 Projects, Activity log and SDK details are available to Project Admins and Team Managers for tasks in Annotate, Review, Complete, Archive, Skip, and External stages. View availability depends on your Project role and the task’s Workflow stage. See View a Task.
The following actions are available from the per-row menu, grouped into sections:

Find a Task ID

In TMS3 Projects, Project Admins and Team Managers can copy the Task ID from SDK details for tasks in Annotate, Review, Complete, Archive, Skip, and External stages. In other Projects, the API details panel doesn’t show the task ID. The task ID appears in the Label Editor’s URL instead:
  • When you open a task from the Queue with View, the URL includes viewTaskId=<task-id>.
  • When you work on a task, the URL includes taskId=<task-id> for annotation tasks, or reviewId=<task-id> for review tasks.
With the SDK, the task ID is the task’s uuid. See Workflows and Stages.
If any mutating action (Assign, Release, Change priority, or Move to stage) fails, Encord displays an error notification. No changes are applied to the task in that case.

Bulk Task Actions

The Actions button lets you perform operations on multiple selected tasks at once. The button appears only after you select one or more tasks:
  • List and Grid views — The Actions button appears inside the floating selection toolbar at the bottom of the screen.
  • Explorer view — The Actions button appears in the top action bar alongside other controls.
The floating selection toolbar displays items in this order: [N] selected · Clear · Select all · Actions.
Hover over Select all to see a tooltip with the hint that you can hold Shift to select a range of tasks.

Export Selected Labels

Project Admins can export labels for selected rows in Complete and Archive stages. Select one or more rows, click Actions, then select Export labels and configure the export. Each selected data unit is exported once, even if multiple selected rows refer to it. Rows that target a dataset subset or have no target are excluded, and the export dialog shows how many rows are excluded. If none of the selected rows targets a single data unit, Export labels is disabled.

View a Task

For Projects other than TMS3, you can open any task from the Queue in view-only mode without assigning it to yourself. In TMS3 Projects, View appears in the task’s ⋯ menu or as a link in the task row based on your Project role and the task’s Workflow stage: In TMS3 Projects, View is unavailable to users who are not Project members. It is also unavailable when a task targets a Dataset subset, or has no target, because there is no single data unit to open. Inline View links support opening the task in a new browser tab. The view-only Label Editor does not show Previous or Next navigation.
To edit labels while viewing a task, click Edit or use Ctrl + E. When finished, click Save and return to view to return to view mode.

Assign Tasks

Only Workspace and Project Admins and Team Managers can assign or release tasks.
You can assign tasks in two ways:
  • Per-row — Click the ⋯ menu on any task row and select Assign, then choose a project member from the submenu.
  • Bulk — Select one or more tasks and use the Actions menu to assign them to a specific annotator or reviewer.
In supported Annotate and Review queues, Project Admins and Team Managers can also click the Assigned to cell and search for a user. The list includes Project Admins, Team Managers, and users with the role required for the stage. If the stage limits its workers, annotators or reviewers must be individually listed or belong to a listed group; Project Admins and Team Managers remain eligible. The current assignee remains listed even if they are no longer eligible. Reassigning a task takes it from its current assignee; you cannot select Unassigned from this menu. Assigned tasks appear in the assignee’s personal Queue view. To release an assignment, use the ⋯ menu on the task row and select Release, or select multiple tasks and choose Release from the Actions menu. In TMS3 Projects, bulk Release is available in Annotate and Review stages. It releases the assigned tasks in your selection and leaves out unassigned tasks. If none of the selected tasks is assigned, Release is disabled. After the action, a notification reports how many tasks were released and explains why any tasks were left out, such as tasks that no longer have an assignee or are no longer in the stage.

Move Tasks

Only Workspace and Project Admins and Team Managers can move tasks.
You can move tasks from their current stage directly to any other stage in the Workflow:
  • Per-row — Click the ⋯ menu on any task row, select Move to stage, then choose the target stage from the submenu.
  • Bulk — Select one or more tasks and use the Actions menu to move them to a different stage.
  • Moving tasks skips all intermediate Workflow stages, placing them immediately into the selected stage.
  • All labels (objects and classifications) are automatically approved when tasks move to a COMPLETE stage.
  • Webhooks do not fire when tasks are moved this way.
  • Tasks cannot be moved into Consensus stages.
  • Tasks in a Consensus Annotate block cannot be moved to Consensus Review blocks.
  • The following analytics do not apply to moved tasks: Labels created, Approved labels, Rejected labels.
  • Agent configuration controls are disabled when a Workflow stage has queued tasks. You must move tasks to another stage before changing the agent configuration.

Reopen Tasks

The Queue doesn’t have a separate Reopen action. To send a task back for more work, use Move to stage and choose an Annotate stage. The task keeps its labels. To reopen many tasks with code, use workflow_reopen() in the SDK. It moves tasks back to the first Annotate stage of the Workflow. See Reopen in the SDK documentation.

Set Task Priority

Only Workspace and Project Admins and Team Managers can set task priority.
You can set task priority in two ways:
  • Per-row — Click the ⋯ menu on any task row and select Change priority. Enter a new priority value in the modal that appears and confirm.
  • Bulk — Select tasks in the Queue and use the Actions menu to assign a priority number.
In supported Annotate and Review queues, Project Admins and Team Managers can also click the priority value in a task row to change it. In Parallelization queues, click the priority value to change it inline, or select tasks and use Actions > Change priority to update them in bulk. Change priority is not available from the task row’s ⋯ menu in these queues. Higher priority numbers cause tasks to appear earlier in the queue. Tasks with the same priority are listed in the order they were created in the stage, oldest first. A data unit’s task in a stage is created when the data unit first reaches that stage. For the first stage of a Workflow, that is when the data unit is added to the Project. For example, if you add Dataset 1 to a Project on Monday and Dataset 2 on Tuesday, Dataset 1’s tasks appear above Dataset 2’s tasks with the same priority. Tasks that were created at the same time, such as the tasks for the data units of one Dataset, have no set order among themselves, so they can appear in any order. To control the order of those tasks, give them different priorities. A task that returns to a stage, for example after it is rejected in a Review stage, keeps its original place in that stage’s queue. To change the priority of tasks when they return to an Annotate stage, use the stage’s Priority on re-entry setting. See Workflows and Templates.

Consensus Annotation Subtasks

In a Consensus Annotation stage, each task expands to show individual subtask rows — one per annotator assigned to that consensus group. Each subtask row has its own Initiate button.

Peer Annotation Gating

When the Show peer annotations setting is enabled on a Consensus Annotation Workflow node, Encord gates peer annotators from starting their subtask until the first annotator completes theirs.
This gating applies only to consensus annotation stages where Show peer annotations is enabled. Consensus stages without this setting are unaffected.
The gating works as follows:
  • The first annotator’s Initiate button is always available immediately.
  • The Initiate button for all other peer annotators (every subtask after the first) is disabled until the first annotator completes their subtask.
  • When a peer annotator hovers over their disabled Initiate button, a tooltip displays: “The first annotation must be completed before peer annotations can be initiated.”
  • Once the first annotator completes their subtask, the Initiate button becomes enabled for all remaining peer annotators.
This gating ensures that peer annotators can view the initial annotation before adding their own, which is the intended purpose of the Show peer annotations setting.
For full details on configuring the Show peer annotations setting, see the Consensus Annotation Workflows page.

Agent Configuration Protection

When a Workflow stage contains queued tasks, agent configuration controls are disabled to prevent disruption of active processing.
If you need to modify an agent configuration for a stage that has tasks:
  1. Navigate to the Queue and select the stage containing the tasks
  2. Move the tasks to another stage using the ⋯ row menu or the Actions menu
  3. Return to the Workflow editor to modify the agent configuration
  4. Move the tasks back to the stage if needed
This protection ensures that tasks are not left in an inconsistent state when agent configurations change.

Starting Annotation or Review

To begin working on tasks directly from the Queue:
  1. Navigate to the relevant Workflow stage using the stage list on the left.
  2. Click Start task to pick up the next available task, or click Initiate next to a specific task to open it directly.
  3. The task opens in the Label Editor.
Start task selects the next available task from the queue’s current filters, so the task it opens matches the tasks shown in the queue.
Use the Start task button for a faster, queue-driven workflow. Use Initiate when you need to open a specific task by name.