> ## Documentation Index
> Fetch the complete documentation index at: https://qawolf-goran-unruffled-wing-322a2c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How to verify and debug your test

> Run your test code in a live browser, identify failures, and use debugging tools to fix issues.

## Run your flow

Click **Run** to execute the flow. A live browser appears in the right panel where you can watch the code execute in real time.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-run-flow.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=50b22a98638e32f0e3132672dd3fb31a" alt="Automate Run Flow" width="1400" height="1416" data-path="images/automate-run-flow.png" />
</Frame>

When the flow completes successfully, a green **Flow passed** banner appears at the top of the editor.

## Debug a failure

If something goes wrong, a red **Flow failed** banner appears at the top of the editor and the failed line is highlighted in red.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-failed-flow.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=1d642df25e3df2b8b53272222cb18e81" alt="Automate Failed Flow" width="1404" height="1416" data-path="images/automate-failed-flow.png" />
</Frame>

You have two options for fixing it:

**Fix with AI** — click **Fix with AI** in the banner to let Automation AI diagnose and repair the failure automatically. You can also describe the problem in the AI chat panel or paste the error directly from the **Logs** tab.

**Run selected lines** — reset the app state in the browser, select the lines you want to test, and click **Run**. This lets you iterate on a specific section without re-running the entire flow.

## Use the debugging panels

The bottom-right panel has four tabs that provide different views of your flow's execution.

**Problems** — the default tab when you open a flow. Appears when QA Wolf detects issues such as naming conflicts. Affected files and folders are marked with a yellow dot in the file tree. Resolve any problems listed before running or publishing to avoid confusing output.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-browser-problem.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=a8b9e9656e2d31db29dc70d250b9b245" alt="Automate Browser Element" width="2694" height="1400" data-path="images/automate-browser-problem.png" />
</Frame>

**Logs** — shows a timestamped execution log. When a flow fails, the error message here is the fastest way to understand what went wrong. You can paste the log output directly into the AI chat panel to get a fix.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-browser-log.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=099d9c3214d843f8af05e9819cd644b5" alt="Automate Browser Log" width="2702" height="1414" data-path="images/automate-browser-log.png" />
</Frame>

**Elements** — lets you enter a locator or CSS selector to highlight matching elements in the live browser. Useful for verifying selectors while writing or debugging a flow. See [Element picker](/qawolf/Use-the-Elements-picker-2c35b2a994fb80a681baca4f6acf3179) for more details.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-browser-element.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=2022fa608dd56e1f9067a4913538b90e" alt="Automate Browser Element" width="2686" height="1398" data-path="images/automate-browser-element.png" />
</Frame>

**Details** — shows tags and readiness status for the current flow. Both fields can be edited directly from this tab. After a run, switches to show individual run steps with timing, useful for identifying slow or hung steps.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-browser-detail.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=8c0115a7df103d18510be96b0a8dc8a3" alt="Automate Browser Detail" width="2696" height="1948" data-path="images/automate-browser-detail.png" />
</Frame>

## Check run history

The **Run History** tab shows a pass/fail chart and the result of the most recent run.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-run-history-1.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=8af3909830561960f167864c58af306e" alt="Automate Run History 1" width="3588" height="1922" data-path="images/automate-run-history-1.png" />
</Frame>

<Note>
  Run History only shows results from scheduled runs. Manual runs from the editor or Map tab do not appear here. See [How Runs work](/qawolf/Run-a-flow-or-suite-2a25b2a994fb8014b164d7ad2efd5ddel) for a full explanation of run types.
</Note>

## Manage tags and readiness status

The **Details** tab shows the tags and readiness status assigned to the current flow. Both fields can be edited directly from this tab using the <Icon icon="pencil" /> icon next to each field.

After a run, the tab switches to display individual run steps with timing, which is useful for identifying slow or hung steps.

<Frame>
  <img src="https://mintcdn.com/qawolf-goran-unruffled-wing-322a2c/l20-3xwG8u36LtQG/images/automate-flows-details.png?fit=max&auto=format&n=l20-3xwG8u36LtQG&q=85&s=c9721144cb655020e82bca7e8183019b" alt="Automate Browser Detail" width="1986" height="854" data-path="images/automate-flows-details.png" />
</Frame>
