--- version: "2026.1.0" language: "en" --- # Hover Web Element The **Hover Web Element** block is used to move the mouse pointer over a web element, such as a button or `div`, in an already open browser window. When the element is hovered, it is automatically scrolled into view if needed. This block works only with browser windows that were opened using the **Start Web Browser** block or one of its child windows. Fully expanded, the **Hover Web Element**block shows the following properties: ![image-20260119-122454.png](https://docs.leapwork.com/__attachments/a_3168b10d05936352dba0fa9edbaab7c4b7180347b529d8b5260ec5da0917cf51/image-20260119-122454.png?cb=dfcfcdf727ad947977f7463a10880460) **Note:** The screenshot on this page uses the **Elegance Design** , introduced in **2025.3**. If you are using an earlier version, your layout may look different. ## Quick-start 1. Drag **Hover Web Element** onto the canvas. 2. Connect the block in the flow and capture the target element in **Select Web Element** ; optionally adjust **Use occurrence** , **Default timeout**, and scrolling or wait options. 3. Run the flow when it's ready and use **Found element** and **Not found** to guide the next steps in your web automation. ## Building block parameters Parameters * **Block header:** Shows the current name of the **Hover Web Element** block. You can rename it by double-clicking the header and typing a new title. The green input connector starts the hover operation when the flow reaches this block, and the green output connector triggers when the element has been hovered successfully. * **Select Web Element:**Contains the locator for the web element to hover. * Right-click and choose **Capture new web element** to capture the element. * Right-click and select **Edit web element** to adjust the locator. * Right-click and select **Clear web element** to remove it. * **Found element:** Holds the found web element in the browser window. You can connect this to **Source element** in other blocks to narrow later searches to this element or its descendants (for example, specific table cells). * **Not found:** Green output connector that triggers if the web element cannot be located before the timeout expires. Use this connector to branch the flow or explicitly fail the case. * **Position found:** The browser canvas position where the web element was found, expressed as X and Y coordinates. The top-left corner of the browser canvas is position `0, 0`. Any non-visible element (for example, hidden via CSS) will have position `0, 0`. * **Area found:** The position and size of the found web element as X, Y, Width, and Height coordinates, starting from the upper-leftmost pixel of the element. The origin `0, 0` is the top-left corner of the screen. * **Attributes:** Lists all attributes on the found web element as key--value pairs, including standard HTML attributes (`class`, `style`, `href`, etc.) and custom attributes (`data-xxx`, and so on). For working more directly with attributes, you can use the **Get Web Attribute** block. * **CSS values:** Reserved for future use. Currently this property is not populated. * **Visible:** Returns `True` if the found web element is visible; otherwise returns `False`. * **Tag name:** The tag name of the found web element, for example `div`, `tr`, `button`, or `input`. * **Source element:**Limits the web element locator to search only inside a specific parent element. * For example, you can set a table element as the source and then search for a particular `tr` or `td` within that table only. * **Browser window:** Specifies which browser window the block should use. This is typically set by a **Start Web Browser** block and can be reused by other web blocks to keep actions in the same window. * **Use occurrence:**Determines which matching element to hover when more than one is found. * Set a specific occurrence index to hover a single match. * Choose **All** to iterate through each occurrence; the main output is triggered once per element. * **Count:** Contains the total number of web elements that matched the locator. Useful for validations or conditional branching based on how many matches exist. * **Current index:** Shows the index of the element currently being hovered when **Use occurrence** is set to **All** . For example, in a list of three matching `div` tags, this will contain `1`, `2`, and `3` across the three iterations. * **Completed:** Green output connector that triggers once all occurrences have been processed when **Use occurrence** is set to **All** . * **Default timeout:**Controls how long the block will search for the element: * When the checkbox is **not selected** , the block uses the explicit **Timeout** value, which defaults to **10 seconds** unless changed. * When the checkbox is **selected** , the block uses the **Default timeout** value from the flow settings. * **Timeout:** Sets the maximum time the block spends searching for the web element before giving up and triggering **Not found** . This timeout is specific to the block. Each case also has a separate global timeout in the **Settings** panel; if that is exceeded, the case is cancelled regardless of this block's timeout. * **Scroll to find:** Enables scrolling while searching for the element when set to a value other than **None**. This is useful in scrollable pages where elements may only appear when scrolled into view or loaded lazily (for example, infinite scroll). * **Max repeats:** how many scroll attempts to perform before giving up. * **Amount:** how far to scroll on each attempt. * **Delay (sec):** pause between scroll actions. * **Require valid imgs:** When selected, any web element locator that targets an image (`img` tag) also verifies that the image loads correctly. For example, by validating that the image source responds successfully. * **Await DOM change:** When selected, delays the search for the web element until there have been no changes to the page's DOM for a specified period (for example, three seconds). This is helpful when waiting for JavaScript updates to finish. The internal wait is capped so the search still proceeds after a maximum of about 30 seconds. * **Await Requests:** When selected, delays the search for the web element until there have been no active XHR requests for a specified period (for example, three seconds). This is useful on enterprise applications that perform heavy background loading. * **Await Timeout:**Defines how many seconds the "await" conditions must stay stable (no DOM changes or no active XHR requests, depending on which options are enabled) before the block proceeds. ## Resources | **Topic** | **Description** | |---------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Flows FAQ](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/flows-faq.md) | Common questions about creating, running, and managing flows in Leapwork. | | [Flows Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/flows-troubleshooting.md) | Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork. | | [Strategy Editor](https://docs.leapwork.com/leapwork-flow/latest/working-with-leapwork/strategy-editor.md) | Guidelines for understanding and using the Strategy Editor in Leapwork to define, refine, and validate robust locator strategies for UI elements using DOM structure, tokens, and wildcards. |