> ## Documentation Index
> Fetch the complete documentation index at: https://qawolf-mintlify-a5022248.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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-run-flow.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=2dd62e219b1fb55e8d65e72a591693ac" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-failed-flow.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=690124d80927e0b5048c55748352f3cc" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-browser-problem.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=951675be34449bd2ddfe8c05be86fe3c" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-browser-log.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=547e064cb45663f75ae2bbda1a093bce" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-browser-element.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=09cf192328a71ade7d771311dd5215fc" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-browser-detail.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=09354f59390dbb072889b757d3a4ecdf" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-run-history-1.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=52a5b883f91bea8fd7def51911dc2e1f" 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-mintlify-a5022248/DEKomTybTjPdcHpw/images/automate-flows-details.png?fit=max&auto=format&n=DEKomTybTjPdcHpw&q=85&s=eb014dcc7fea5083c2cdabbe040b19c7" alt="Automate Browser Detail" width="1986" height="854" data-path="images/automate-flows-details.png" />
</Frame>
