Read Table

Read Table

This block lets you fetch a specified range of values using a table construct that Leapwork has grabbed from the green screen, meaning faster test creation.

Leapwork “invents” a table and reads columns and names to get an occurrence and read the fields underneath it.

Building Block Header

The green input connector (top left) triggers this block to begin execution.

The green output connector (top right) is triggered when the table values have been fetched.

You can always change the title of a block by double-clicking on it and typing in a new title.

Table Name

This is the field that Leapwork will look for; it represents the beginning of a table that the block will work with.

Use occurrence

This allows you to specify which occurrence to use in case you have multiple matches.


This refers to the data selection method, whether:

First row - always select the first row in the range
Row index - select a specific row, such as the 5th row
Iterate - continue reading all rows in the range. The top connector is triggered for each data row in the selected data range.

Trim spaces

This removes all of the white space before and after the text.

Not found

The green output connector is triggered if the field representing the table is not found before the timeout (see below). This is typically used to a flow or to explicitly fail a case by linking it to a Fail block.

Default timeout

If the 'Default Timeout' property checkbox is not selected, then the timeout value will be set to 10 seconds unless changes manually. If the 'Default Timeout' property checkbox is selected, then the 'Default timeout' value selected in the flow settings (under “Max. run time) will be applied.

The Green Screen Recorder and building blocks are available with Enterprise plans.