> For the complete documentation index, see [llms.txt](https://docs.zerowork.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zerowork.io/using-zerowork/using-building-blocks/hover-web-element.md).

# Hover Web Element

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FOoAIB0wVtdtF674dipke%2Fhover_web_element_block.png?alt=media&amp;token=79168b1a-a1ba-42ed-8f93-db3bf74cd571" alt="" width="375"><figcaption></figcaption></figure>

The **Hover Web Element** block moves the mouse over an element, the way you would to reveal a drop-down menu, a tooltip, or content a site only shows on hover.

{% hint style="info" %}
Hovering is usually only the first step of using revealed content. Follow it with the block that acts on whatever appears: for example, a [Click Web Element](https://docs.zerowork.io/using-zerowork/using-building-blocks/click-web-element) block on a menu item, or a [Save Web Element](https://docs.zerowork.io/using-zerowork/using-building-blocks/save-web-element) block on a value that shows up on hover.
{% endhint %}

## How To Use It

<figure><img src="https://3220183989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg9LcR8XM7TGOzOCDGsCS%2Fuploads%2FzHJGzGv0pyoInVUiHymj%2Fhover_web_element_settings.png?alt=media&amp;token=fab8f151-6fcb-477f-9706-27058e0f4da6" alt=""><figcaption></figcaption></figure>

### Web Element Selector

The CSS or XPath selector for the element to hover over. See [Using Selectors](https://docs.zerowork.io/using-zerowork/using-selectors). If it matches more than one element, the first match is used.

#### Timeout

How long to wait for the element to appear before giving up, in seconds. The default is **1 second**.

#### Block-level Delays

**Min sec** and **Max sec** represent a pause after the hover, before the next block runs. The wait is randomized between the two values, and setting both to the same number makes it fixed. This block defaults to **2 seconds**.

{% hint style="info" %}
See the [Delay](https://docs.zerowork.io/using-zerowork/using-building-blocks/delay) block for how these two fields behave, including decimals, references, and what happens when a field is left empty. See [Delay Times between the Building Blocks](https://docs.zerowork.io/using-zerowork/using-building-blocks/building-block-options/delay-times-between-the-building-blocks) for how block-level delays fit into a TaskBot's run.
{% endhint %}

## Things To Know

* **It reveals hover-only content, then you act on it.** Menus, tooltips, timestamps, and action icons that a page shows only while the mouse is over an element aren't reachable until you hover. Hover first, then target what appears with the next block.
* **Keep the hover and the follow-up block close together.** Whatever appears on hover usually disappears the moment the mouse moves away, and your next block may move it. Put the block that acts on the revealed content immediately after, and point it straight at that content.
* **What appears on hover may live elsewhere in the web page's code.** Menus, tooltips, and popovers are often injected into a separate part of the page, frequently near the end of it, instead of right beside the element you hovered. When you build the selector for the next block to act on what appears, point it at that content directly rather than assuming it sits inside or next to the hovered element.
* **Hover only triggers&#x20;*****hover*****&#x20;effects.** If a menu opens on a **click** rather than a mouse-over, this block won't open it; use [Click Web Element](https://docs.zerowork.io/using-zerowork/using-building-blocks/click-web-element) block instead.

## Block Behavior

**When the element is found** the block moves the mouse over it, and logs that it hovered over the element, noting the selector used.

**When the element can't be found within the timeout** the block fails with a selector error and stops the run.
