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

# Keyboard shortcuts for trace and span navigation

> Navigate traces and spans in the Braintrust UI using keyboard shortcuts, including arrow keys for the log list and p/n for span navigation.

export const plans_0 = "Any"

export const deployments_0 = "Any"

export const data_plane_version_0 = undefined

export const use_case_0 = "Use case - Navigate traces and inspect spans using keyboard shortcuts in the Braintrust UI"

<Note>
  **Applies to:**

  * Plan - {plans_0}
  * Deployment - {deployments_0}
  * {data_plane_version_0}
  * {use_case_0}
</Note>

## Summary

Arrow keys move between traces in the log list. Span-level navigation in the side (trace) view uses different keys. Use `p` and `n`, and ensure the side panel has keyboard focus.

## What is happening

When focus is on the log list, `ArrowUp` and `ArrowDown` move the selected trace. Opening a trace shows its spans in a side panel. The same arrow keys do not step through spans in that panel. Span navigation requires a different keyboard context and different keys. The side panel must have focus for span keys to be active.

## Suggested use

### Option 1: use the built-in span keys (recommended)

1. Select a trace in the log list using `ArrowUp` or `ArrowDown`.
2. Open the trace in the side panel (click the trace or open it as you normally do).
3. Click once inside the side panel or press `Tab` until the panel has focus.
4. Press `n` to go to the next span and `p` to go to the previous span.
5. Press `Shift` + `/` to open the keyboard shortcuts modal for other bindings.

### Option 2: keyboard-first focus workflow

1. Navigate to the trace in the list with `ArrowUp` or `ArrowDown`.
2. Navigate to the trace in the list with `ArrowUp` / `ArrowDown`.
3. Open the trace.
4. Use `Tab` to move focus from the list into the side panel.
5. Use `n` and `p` to step through spans once the panel is focused.

## How to confirm it worked

* With a trace open and the side panel focused, press `n` repeatedly and observe the highlighted span advancing.
* With focus on the log list, press `ArrowDown` and confirm the selected trace changes.

## Notes

* Press `Shift` + `/` on any page to view all supported keyboard shortcuts.
* If keys do not work, ensure your browser or an extension is not intercepting the keystrokes.