# Get Web Dropdown

The **Get Web Dropdown** block retrieves the selected option from a dropdown element on a web page. It returns the selected **index**, **text**, and **value** for use in downstream blocks. This block only works with browser windows that were opened using the Start Web Browser block or their "child" windows.

Fully expanded, the **Get Web Dropdown** block shows the following properties:

**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 **Get Web Dropdown** onto the canvas.

2. Specify the basic parameters required for this block to operate: **Select Dropdown element**.

3. Run the flow when it's ready.

## Building block parameters

### Parameters  
* **Block header**: The green input connector triggers the block to start executing. The green output connector triggers when the dropdown has been successfully read. You can rename the block title ("Get Web Dropdown") by double-clicking it and typing a new title.

* **Select Dropdown Element**: Contains the locator for the dropdown web element to read. You can capture a locator by right-clicking and selecting **Capture new web element**, edit it via **Edit web element**, and clear it via **Clear web element**.

* **Selected Index**: Provides the index of the selected dropdown option as an output that can be connected to other building blocks.

* **Selected Text**: Provides the text of the selected dropdown option as an output that can be connected to other building blocks.

* **Selected value**: Provides the value of the selected dropdown option as an output that can be connected to other building blocks.

* **Not found**: Triggers if the dropdown element is not found before the timeout. This is typically used to branch execution flow or to explicitly fail a case by linking it to a **Fail** block.

* **Default timeout**: If the checkbox is not selected, the timeout is **10 seconds**. If the checkbox is selected, the **Default timeout** value from the flow settings applies.

* **Timeout**: The maximum time spent searching for the dropdown element before giving up and triggering **Not found**. This is separate from the case **global timeout** in **Settings**, which can cancel a run if the whole case exceeds it.

* **Source element**: Limits the dropdown locator to only search inside a specified source element (for example, within a previously found table element).

* **Browser window**: Makes the block use a specific browser window. Multiple browser windows are not supported by Selenium Grid or external cloud providers such as [Sauce Labs](https://saucelabs.com/) and [BrowserStack](https://browserstack.com/).

* **Use Occurrence**: Selects which occurrence of the dropdown to use when more than one match is found. Select **All** to iterate through all occurrences; the block output triggers for each occurrence, and **Current index** and **Completed** are shown.

* **Current index**: When iterating through all occurrences, contains the current occurrence index being processed.

* **Completed**: Triggers when the iteration of all occurrences has completed.

* **Count**: Contains the total number of found dropdown elements that match the locator.

* **Await DOM change**: Delays the search until there have been no changes to the page's DOM for a specified period (for example, 3 seconds). Regardless of this checkbox, the action proceeds after waiting a maximum of **30 seconds**.

* **Await Timeout**: The number of seconds the DOM must have had no changes before proceeding.

* **Await Requests**: Delays the search until there have been no active XHR requests for a specified period (for example, 3 seconds). Regardless of this checkbox, the action proceeds after waiting a maximum of **30 seconds**.