> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-javaex-1765204202-a1f8093.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Use annotation queues

*Annotation queues* provide a streamlined, directed view for human annotators to attach feedback to specific [runs](/langsmith/observability-concepts#runs). While you can always annotate [traces](/langsmith/observability-concepts#traces) inline, annotation queues provide another option to group runs together, then have annotators review and provide [feedback](/langsmith/observability-concepts#feedback) on them.

## Create an annotation queue

To create an annotation queue:

1. Navigate to the **Annotation queues** section on the left-hand navigation panel of the [LangSmith UI](https://smith.langchain.com).
2. Click **+ New annotation queue** in the top right corner.

   <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/xyxO5nIH789Qj0Gp/langsmith/images/create-annotation-queue-new.png?fit=max&auto=format&n=xyxO5nIH789Qj0Gp&q=85&s=75199c4b54c40ced536e73bbf70c014b" alt="Create Annotation Queue form with Basic Details, Annotation Rubric, and Feedback sections." width="3456" height="1912" data-path="langsmith/images/create-annotation-queue-new.png" />

### Basic Details

1. Fill in the form with the **Name** and **Description** of the queue. You can also assign a **default dataset** to queue, which will streamline the process of sending the inputs and outputs of certain runs to datasets in your LangSmith [workspace](/langsmith/administration-overview#workspaces).

### Annotation Rubric

1. Draft some high-level instructions for your annotators, which will be shown in the sidebar on every run.
2. Click **+ Desired Feedback** to add feedback keys to your annotation queue. Annotators will be presented with these feedback keys on each run.
3. Add a description for each, as well as a short description of each category, if the feedback is categorical.

   <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/xyxO5nIH789Qj0Gp/langsmith/images/create-annotation-rubric.png?fit=max&auto=format&n=xyxO5nIH789Qj0Gp&q=85&s=a78d26e78f4d64bcf127d5e26969ba3d" alt="Annotation queue rubric form with instructions and desired feedback entered." width="3456" height="1914" data-path="langsmith/images/create-annotation-rubric.png" />

   For example, with the descriptions in the previous screenshot, reviewers will see the **Annotation Rubric** details in the right-hand pane of the UI.

   <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/hkiKbDId68Vbb3Mq/langsmith/images/rubric-for-annotators.png?fit=max&auto=format&n=hkiKbDId68Vbb3Mq&q=85&s=3906a0cf6310333a72e17809c37cb587" alt="The rendered rubric for reviewers from the example instructions." width="3456" height="1912" data-path="langsmith/images/rubric-for-annotators.png" />

### Collaborator Settings

When there are multiple annotators for a run:

* **Number of reviewers per run**: This determines the number of reviewers that must mark a run as **Done** for it to be removed from the queue. If you check **All workspace members review each run**, then a run will remain in the queue until all [workspace](/langsmith/administration-overview#workspaces) members have marked their review as **Done**.

  * Reviewers cannot view the feedback left by other reviewers.
  * Comments on runs are visible to all reviewers.

* **Enable reservations on runs**: When a reviewer views a run, the run is reserved for that reviewer for the specified **Reservation length**. If there are multiple reviewers per run as specified above, the run can be reserved by multiple reviewers (up to the number of reviewers per run) at the same time.

  <Tip>
    We recommend enabling reservations. This will prevent multiple annotators from reviewing the same run at the same time.
  </Tip>

  If a reviewer has viewed a run and then leaves the run without marking it **Done**, the reservation will expire after the specified **Reservation length**. The run is then released back into the queue and can be reserved by another reviewer.

  <Note>
    Clicking **Requeue** for a run's annotation will only move the current run to the end of the current user's queue; it won't affect the queue order of any other user. It will also release the reservation that the current user has on that run.
  </Note>

As a result of the **Collaborator settings**, it's possible (and likely) that the number of runs visible to an individual in an annotation queue differs from the total number of runs in the queue compared to another user's queue size.

You can update these settings at any time by clicking on the pencil icon <Icon icon="pencil" /> in the **Annotation Queues** section.

## Assign runs to an annotation queue

To assign runs to an annotation queue, do one of the following:

* Click on **Add to Annotation Queue** in top right corner of any [trace](/langsmith/observability-concepts#traces) view. You can add any intermediate [run](/langsmith/observability-concepts#runs) (span) of the trace to an annotation queue, but not the root span.

  <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/pmUDr_9RN_m5cIdx/langsmith/images/add-to-annotation-queue.png?fit=max&auto=format&n=pmUDr_9RN_m5cIdx&q=85&s=99357437c7fdeb6a1ab09c9a73a5e0a3" alt="Trace view with the Add to Annotation Queue button highglighted at the top of the screen." width="1373" height="1028" data-path="langsmith/images/add-to-annotation-queue.png" />

* Select multiple runs in the runs table then click **Add to Annotation Queue** at the bottom of the page.

  <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/ZPc-9yp1tnWMgq79/langsmith/images/multi-select-annotation-queue.png?fit=max&auto=format&n=ZPc-9yp1tnWMgq79&q=85&s=1c25d852315fe57755177213a993dd45" alt="View of the runs table with runs selected. Add to Annotation Queue button at the botton of the page." width="1323" height="1317" data-path="langsmith/images/multi-select-annotation-queue.png" />

* [Set up an automation rule](/langsmith/rules) that automatically assigns runs that pass a certain filter and sampling condition to an annotation queue.

* Navigate to the **Datasets & Experiments** page and select a dataset. On the dataset's page select one or multiple [experiments](/langsmith/evaluation-concepts#experiment). At the bottom of the page, click **<Icon icon="pencil" /> Annotate**. From the resulting popup, you can either create a new queue or add the runs to an existing one.

  <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/V9pf-2kFbKZrbfYJ/langsmith/images/annotate-experiment.png?fit=max&auto=format&n=V9pf-2kFbKZrbfYJ&q=85&s=d987bd1ed4133b24aa2b0c55b8875b23" alt="Selected experiments with the Annotate button at the bottom of the page." width="3456" height="1914" data-path="langsmith/images/annotate-experiment.png" />

<Check>
  It is often a good idea to assign runs that have a particular type of user feedback score (e.g., thumbs up, thumbs down) from the application to an annotation queue. This way, you can identify and address issues that are causing user dissatisfaction. To learn more about how to capture user feedback from your LLM application, follow the guide on [attaching user feedback](/langsmith/attach-user-feedback).
</Check>

## Review runs in an annotation queue

To review runs in an annotation queue:

1. Navigate to the **Annotation Queues** section through the left-hand navigation bar.
2. Click on the queue you want to review. This will take you to a focused, cyclical view of the runs in the queue that require review.
3. You can attach a comment, attach a score for a particular [feedback](/langsmith/observability-concepts#feedback) criteria, add the run to a dataset or mark the run as reviewed. You can also remove the run from the queue for all users, despite any current reservations or settings for the queue, by clicking the **Trash** icon <Icon icon="trash" /> next to **View run**.

   <Tip>
     The keyboard shortcuts that are next to each option can help streamline the review process.
   </Tip>

   <img src="https://mintcdn.com/langchain-5e9cc07a-preview-javaex-1765204202-a1f8093/hkiKbDId68Vbb3Mq/langsmith/images/review-runs.png?fit=max&auto=format&n=hkiKbDId68Vbb3Mq&q=85&s=6c28d2f56a8c57f39d5fb3e8adf58054" alt="View or a run with the Annotate side panel. Keyboard shortcuts visible for options." width="1532" height="1080" data-path="langsmith/images/review-runs.png" />

## Video guide

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/rxKYHA-2KS0?si=V4EnrUmzJaUVJh0m" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

***

<Callout icon="pen-to-square" iconType="regular">
  [Edit the source of this page on GitHub.](https://github.com/langchain-ai/docs/edit/main/src/langsmith/annotation-queues.mdx)
</Callout>

<Tip icon="terminal" iconType="regular">
  [Connect these docs programmatically](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
</Tip>
