> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Playwright AI Failure Analysis Overview

> AI failure classification and cross-run pattern analysis.

AI Insights classifies failures across runs for a selected time period and environment. Use the category totals and pattern tables to pick what to fix first.

<Note>
  AI features are on by default. Toggle them in [Project Settings → AI Features](/platform/project-settings#ai-features). Changes apply from the next test run.
</Note>

## Review failures

1. Set **Time range** and **Environment** and keep them fixed for the review
2. Read the category tiles for totals and top affected tests
3. Open **Persistent** and **Emerging** patterns to prioritize

## Categories

![key metrics](https://tdstorageus.blob.core.windows.net/public/docs/ai-and-automation/ai-insights/playwright-ai-failure-analysis/key-metrics.webp)

| Category          | Meaning                                               |
| :---------------- | :---------------------------------------------------- |
| **Actual Bug**    | Consistent failure that points to a product defect    |
| **UI Change**     | Selector or DOM change broke a step                   |
| **Unstable Test** | Intermittent failure that passes on retry             |
| **Miscellaneous** | Setup, data, or CI issue outside the categories above |

Each card shows the total and top-impacted tests with per-test counts. Platform map: [AI Overview](/ai/overview).

## Failure patterns

Cross-run view grouped by cause. Filter by period and environment, then open the worst offenders. Columns: **Test Name**, **Branch**, **Run IDs**, **Failures**.

### Persistent Failures

Tests failing across multiple runs in the window.

![Persistent failures](https://tdstorageus.blob.core.windows.net/public/docs/ai-and-automation/ai-insights/playwright-ai-failure-analysis/persistent-failures.webp)

### Emerging Failures

Tests that started failing recently and are appearing again.

![Emerging failures](https://tdstorageus.blob.core.windows.net/public/docs/ai-and-automation/ai-insights/playwright-ai-failure-analysis/emerging-failures.webp)

<CardGroup cols={2}>
  <Card title="AI Overview" icon="sparkles" href="/ai/overview">
    All AI features and where they appear
  </Card>

  <Card title="Test Run AI Insights" icon="play" href="/platform/playwright-test-runs/ai-insights">
    Classification and patterns for one run
  </Card>

  <Card title="Test Case AI Insights" icon="flask" href="/platform/playwright-test-cases/ai-insights">
    Per-test recommendations and quick fixes
  </Card>

  <Card title="Error Grouping" icon="layer-group" href="/guides/playwright-error-grouping">
    Cluster failures by message and stack
  </Card>
</CardGroup>
