> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Score traces and datasets

> Open logs, experiments, and dataset rows in review mode, set scores, add comments, and move through rows efficiently to record human judgments.

Once you've [configured review scores](https://docs.braintrust.dev/annotate/human-review.md#configure-review-scores), reviewers record judgments row by row in review mode. This page covers starting a review, setting scores, and moving through rows efficiently.

## Start reviewing

1. Go to [** Review**](https://www.braintrust.dev/app/~/review) and select the type of data to review:
   * **Log spans**: production traces and debugging sessions.
   * **Experiment spans**: evaluation results and test runs.
   * **Dataset rows**: test cases and examples.
2. Select a row and set scores. While reviewing, you can also [add comments and tags](https://docs.braintrust.dev/annotate/labels.md), add the span to a [dataset](https://docs.braintrust.dev/annotate/datasets/create.md#promote-traces-from-logs) or a [playground](https://docs.braintrust.dev/observe/view-logs.md#iterate-in-playgrounds), and assign it to a teammate. On LLM spans, the **Run** button lets you [view and run the prompt](https://docs.braintrust.dev/observe/examine-traces.md#re-run-a-prompt).
3. Click **Mark complete** to record your review.

By default, marking a review complete keeps you on the current row. To move to the next row automatically, enable the **Auto-advance** toggle. The button then reads **Mark complete and continue**. You can also navigate with the **Next row** and **Previous row** buttons.

> [!TIP]
>
> You can also enter review mode directly from the [\*\* Logs\*\*](https://www.braintrust.dev/app/~/logs) table or an individual experiment table in [\*\* Experiments\*\*](https://www.braintrust.dev/app/~/experiments) using the **Review** button or the `r` shortcut. The review will be scoped to the set of traces in the current filter. See [Review specific rows in Logs and Experiments](https://docs.braintrust.dev/kb/review-button-ignores-selected-rows-in-logs).

> [!NOTE]
>
> Not all score types appear on dataset rows. Only [categorical scores](https://docs.braintrust.dev/annotate/human-review.md#configure-review-scores) configured to "write to expected" and free-form scores are available for dataset reviews, since datasets store test data (input/expected pairs) rather than subjective quality assessments.

When the same span is scored by more than one person, see [Review with multiple reviewers](https://docs.braintrust.dev/annotate/human-review/multiple-reviewers.md) for how Braintrust combines their scores.

## Change the trace layout

While reviewing log and experiment traces, you see detailed information about the flagged span by default. To switch between hierarchy, timeline, thread, and other layouts, see [Examine traces](https://docs.braintrust.dev/observe/examine-traces.md). When reviewing experiment spans, enable the **Diff** toggle in the review modal header and use the **Comparing trace with** dropdown to select a comparison experiment and compare the trace inline while scoring. For an overview of diff mode and its sub-modes, see [Use diff mode](https://docs.braintrust.dev/evaluate/compare-experiments.md#use-diff-mode).

When the raw trace is hard to read, build a [custom view](https://docs.braintrust.dev/annotate/custom-views.md) that renders each span as a purpose-built annotation interface. This is especially useful for large-scale review and for subject-matter experts who shouldn't have to parse JSON to score accurately.

## Next steps

* [Manage review work](https://docs.braintrust.dev/annotate/human-review/manage-review-work.md) to assign and track review across your team
* [Review with multiple reviewers](https://docs.braintrust.dev/annotate/human-review/multiple-reviewers.md) on the same span
* [Add labels and corrections](https://docs.braintrust.dev/annotate/labels.md) to categorize and tag traces


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.