# Watch videos

Videos show the browser session as it happened. They are useful when a screenshot captures the final state but not the sequence that caused it.

## Open a video

1. Open **Runs**.
2. Select a completed run.
3. Open the **Videos** tab.
4. Select the video for the test you want to inspect.

The Videos tab lists video rows with the associated test label and size when that information is available.

## What to watch for

Use the video to answer sequence questions:

| Question                           | What to look for                                         |
| ---------------------------------- | -------------------------------------------------------- |
| Did the test reach the right page? | Navigation, redirects, and login state.                  |
| Did the page finish loading?       | Spinners, delayed content, or slow API responses.        |
| Did a click or input happen?       | Whether the browser performed the expected action.       |
| Did something block the UI?        | Modals, overlays, banners, or disabled controls.         |
| Did the layout change?             | Responsive behavior, clipped content, or hidden buttons. |

## Match video with other evidence

Videos are strongest when used with the failed row details:

1. Open the failed row and read the failure reason.
2. Open the matching video.
3. Watch the actions leading up to the failure.
4. Compare with the screenshot or trace if the cause is still unclear.

## If videos are missing

Videos may be unavailable when:

| Reason                                        | What to check                                        |
| --------------------------------------------- | ---------------------------------------------------- |
| The run configuration does not record video   | Review the selected run configuration.               |
| Video is retained only on failure             | Passed tests may not keep video artifacts.           |
| The workflow ended before Playwright launched | Check setup, dependencies, secrets, and runner logs. |
| The run is still finalizing                   | Wait for artifacts to finish processing.             |
| Artifacts expired or were deleted             | Use a newer run or re-run the test.                  |

For deeper event-by-event debugging, see [Open traces](/results/open-traces.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testvibe.com/results/watch-videos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.