> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/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/WhusTdYQKIe4Ucwh/images/automate-run-flow.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=9b06e96811032da3c1a391c4d9dfcec0" 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/WhusTdYQKIe4Ucwh/images/automate-failed-flow.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=184676a24117cc83ad1ac9f4574d9a28" 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/WhusTdYQKIe4Ucwh/images/automate-browser-problem.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=ac0381e542120c5abbed5b0d55436806" 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/WhusTdYQKIe4Ucwh/images/automate-browser-log.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=65e901872af6ed32d00cefdbce046ab8" 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/WhusTdYQKIe4Ucwh/images/automate-browser-element.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=804b6b598ab331a081a1dbc1845c1a28" 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/WhusTdYQKIe4Ucwh/images/automate-browser-detail.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=5c8a1edf2867649e07661adb472e0a34" 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/WhusTdYQKIe4Ucwh/images/automate-run-history-1.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=92d50426e4de26109456e676ac8087e8" 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/WhusTdYQKIe4Ucwh/images/automate-flows-details.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=b803333b0177a897b6c8d11292be1fb2" alt="Automate Browser Detail" width="1986" height="854" data-path="images/automate-flows-details.png" />
</Frame>
