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

**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) | Common questions about creating, running, and managing flows in Leapwork. |
| [Flows Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/flows-troubleshooting) | Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork.