Participant review

A React block (a whole screen) in Beamline's Research & design app.

One participant's session, answer by answer, beside the list of everyone who took the study. The list filters (finished, left early, with a recording) and says how many match; the open participant stays open when a filter leaves them out, said; previous and next step through the list. The session's details (source, device, country, when, time) open on demand, or are said to be hidden for the reviewer's role. Answers come in study order with their time and outcome: text, a rating, choices, a prototype task's outcome and path; the block a person left at is said, blocks after it are not reached, and whether a recording exists is said apart from whether they finished. Reviewer tags on an answer save without touching the answer; a failed save puts them back and says why.

Use it for

Reading one participant's answers across a whole study, and tagging what they said.
Any review of form or survey responses person by person.

Not for

Recorded web sessions (session-replay).
Aggregate results (task-results).

Anatomy

header: the product's mark, the title and study
list: filter, count, a note when the open participant is outside it, participants with finished or left early and how much they answered
session: the id and status, details, previous, position, next; details or the hidden note; answers in study order with number, block, time, the answer, recording or not, tags

States

finished (green), left early (amber); the block they left at (amber), not reached (faded)
outcomes: direct (green), indirect (light green), gave up (red)
recording or none, said apart from finishing
details shown, hidden for the role (said)
filter: nobody matches, open participant outside it (said)
tags: saving, saved (green), failed and put back (red)
phone: one column
right to left: the page mirrors

Keyboard

Tab through the filter, participants, details and each answer's actions; Enter adds a tag; Backspace in an empty tag field removes the last

Motion

Nothing moves; changes appear on input.

Props

Prop	Type	Default	Description
`study` (required)	`string`	—
`blocks` (required)	`StudyBlockRef[]`	—
`sessions` (required)	`ParticipantSession[]`	—
`defaultParticipant`	`string`	—
`defaultFilter`	`"all" \| "complete" \| "partial" \| "recording"`	—
`restricted`	`boolean`	—	The reviewer can't see participant details.
`onTag`	`((participant: string, block: string, tags: string[]) => Promise<void>)`	—	Saves a response's tags; a rejection puts them back.
`onWatch`	`((participant: string, block: string) => void)`	—
`product`	`string`	—	Your product's name, shown as its mark.
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Import

import { ParticipantReview } from "@beamline/participant-review";

Get it

Participant review is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent