---
title: "Hover over an element in a web test"
sidebarTitle: "Hover"
description: Move the mouse over an element to reveal menus, tooltips, and hover states.
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Move the mouse over an element without clicking it. Use it to open dropdown menus that expand on hover, reveal tooltips, or trigger any `:hover` styling you want to interact with or verify.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Target element | Yes, unless a manual selector is set | Natural-language description of the element. The AI uses it to find the element. |
| Manual selector | No | XPath or CSS selector, used when AI is disabled or as the saved selector. |
| AI usage | No | `inherit` (default, follows the test strategy), `smart`, or `always`. |
| Enable AI | No | When off, only the manual selector is used. Default: on. |
| Ignore error on this step | No | The run continues with the next step if this one fails. Default: off. |

## Results and metrics

- **Timing**: start, end, and duration (in seconds) recorded in the step result.
- **Status**: success, warning, or failed, with the error message on failure.
- **Screenshot**: captured while the hover state is active, showing what it revealed.
- **AI usage**: if the AI located the element, the healed selector is saved on the test and the AI cost is added to the run.

## What's next?

<Columns cols={2}>
  <Card title="Click" icon="arrow-pointer" href="/tests/actions/web/click">

    Click the menu entry the hover revealed

</Card>
  <Card title="Verify element" icon="eye" href="/tests/actions/web/verifyelement">

    Check that the tooltip or menu actually appeared

</Card>
</Columns>