# Read Excel

Node type `browser_useExcel`

## What it does

Read data from a local Excel workbook.

## Desktop client configuration

![Read Excel configuration in the desktop client](/assets/use-excel.8897d407e85c0f101214713117557743cfa0c66be4ab7bcb8a5ed549cb0af158.0538f3a9.webp)

Captured in the English interface of MoreLogin Desktop V2.73.101.

## Inputs

These fields belong in `data.browserUi.inputs`.

| Field | Type or values | Schema required | Execution default | Description and bounds |
|  --- | --- | --- | --- | --- |
| `path` | `string` | No | — | Excel file |
| `sheetName` | `string` | No | — | Worksheet |
| `filterEnabled` | `boolean` (supports variable references) | No | `false` | Filter rows. Editor initial value `false` |
| `conditions` | array<`object`> | No | — | Filter conditions |
| `conditionLogic` | `"and"` / `"or"` (supports variable references) | No | `"and"` | Condition logic. Editor initial value `"and"` |


## Mode requirements and limits

- sheetName (required) selects the worksheet. filterEnabled/conditions/conditionLogic filter whole rows, and sourceRowCount is returned. path is an absolute local path, and the actual file is read at run time.
- Validation code `RPA_NODE_INPUT_INVALID`


## Input references

| Field | Allowed forms |
|  --- | --- |
| `path` | `literal`, `template` |
| `sheetName` | `literal`, `template` |
| `filterEnabled` | `literal`, `template` |
| `conditions` | `literal` |
| `conditionLogic` | `literal`, `template` |


## Outputs

| Output field | Type or values |
|  --- | --- |
| `rows` | array<`object`> |
| `rowCount` | `number` |
| `sourceRowCount` | `number` |
| `columns` | array<`string`> |
| `sheetName` | `string` |
| `materials` | `["null","boolean","number","string"]` / array<`JSON`> / `object` |
| `skipped` | `boolean` |


Reference published fields as `${nodeId.data.field}`.

## JSON example

A complete node object for a workflow's `nodes` array or another node's `blocks`. Replace the local paths with absolute paths on your machine.

```json
{
  "id": "read_accounts",
  "type": "browser_useExcel",
  "data": {
    "title": "Read the account sheet",
    "browserAction": "useExcel",
    "browserUi": {
      "inputs": {
        "path": "/Users/example/Documents/accounts.xlsx",
        "sheetName": "Sheet1",
        "filterEnabled": false
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[Back to the node catalog](/browser-rpa/nodes)