---
version: "2026.1.0"
language: "en"
---
# Get Value

The **Get Value** block retrieves a value from a green screen based on Leapwork's intelligent field recognition. It identifies the nearest **Protected** field (typically a label) and then finds the first matching **Unprotected** field following it. This strategy significantly simplifies automation in green screen environments by avoiding manual pixel-based targeting.

Fully expanded, the **Get Value** block shows the following properties:  
![image-20251218-112035.png](https://docs.leapwork.com/__attachments/a_5c33c254a403d89756e29f5365cca39a3e14fd8cbd12480b9546614d0c36e974/image-20251218-112035.png?cb=730ee57fc84d7908e805737eefc6005f)

**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 Value** onto the canvas.

2. Connect the block in the flow and optionally specify basic parameters such as **Field name** , **Use occurred** , **Index** , **Position** , and **Text fields**.

3. Run the flow when it's ready.

### Building block parameters

Parameters  
* **Block header:** Shows the current name of the Get Value block. You can rename it by double-clicking the header and typing a new title.

* **Field name** : Used to identify the reference **Protected** field. This is auto-resolved by Leapwork based on the closest field to the left of the value you want to retrieve.

* **Text fields:** Stores custom key--value pairs. These values can be reused dynamically in other fields (such as *Field name* ) using the **Insert token** feature.

* **Use occurred:** Specifies which occurrence to use when there are multiple matches for the same **Field name** . For example, if "Username" appears three times, setting this to 2 will use the second match.

* **Index:** Identifies which **Unprotected** field should be used if there are multiple unprotected fields aligned with the same **Protected** label. The input can be fed from another block, and the value can be passed forward as output.

* **Position** : Specifies a particular screen coordinate to locate the value, using a row and column format. Use this only if you need precise positional targeting.

* **Value** : Returns the text or number fetched from the green screen field.

* **Length:** Outputs the length of the retrieved value. For example, for the value "Username", the length would be 8.

* **Is Modified:** Returns **true** if the target field was unprotected and its default value was changed by the user.

* **Is Protected:** Returns **true** if the identified field is **Protected** , meaning it is read-only.

* **Is High Intensity:** Returns **true** if the field is visually highlighted (e.g., with bold or colored text), indicating a special attribute.

* **Is Visible On Display:** Returns **true** if the field is visible (i.e., not hidden like a password).

* **Not found:** This output triggers if the specified field is not found before timeout. You can use this to route to a **Fail** block or handle errors explicitly.

* **Default timeout** : If unchecked, the timeout is **10 seconds** unless changed manually. If checked, the block uses the flow's **Default timeout** under **Max. run time** .

* **Timeout** : The maximum time spent trying to find and fetch the field value before giving up and triggering **Not found** . This value is used when **Default timeout** is unchecked (default is **10 seconds** unless changed manually).

### 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. |