# Get iframe

Node type `browser_getFrame`

## What it does

Locate an iframe so later actions can run inside its document.

## Desktop client configuration

![Get iframe configuration in the desktop client](/assets/get-frame.89eca60943fed60c90e6e3563dc159e6d725f65cb60c4e5ed7a2019d5f481758.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 |
|  --- | --- | --- | --- | --- |
| `selectorType` | `"selector"` / `"element"` / `"frame"` (supports variable references) | No | `"selector"` | Search scope. Editor initial value `"selector"` |
| `frame` | `string` | No | — | iframe |
| `element` | `string` | No | — | Container element |
| `selectorRadio` | `"CSS"` / `"XPath"` (supports variable references) | No | `"CSS"` | Selector type. Editor initial value `"CSS"` |
| `selector` | `string` | No | — | Selector |
| `outputRange` | `"single"` / `"all"` (supports variable references) | No | `"single"` | When multiple element objects match. Editor initial value `"single"` |
| `serialType` | `"fixed"` / `"randomInterval"` (supports variable references) | No | `"fixed"` | When multiple element objects match. Editor initial value `"fixed"` |
| `serial` | `WorkflowNumber` | No | `1` | Element index; integer; minimum after resolution: 1. Editor initial value `1` |
| `serialMin` | `WorkflowNumber` | No | — | Minimum index; integer; minimum after resolution: 1 |
| `serialMax` | `WorkflowNumber` | No | — | Maximum index; integer; minimum after resolution: 1 |
| `type` | `"contentFrame"` (supports variable references) | No | `"contentFrame"` | Output type. Editor initial value `"contentFrame"` |


## Mode requirements and limits

- The node finds an iframe in the current page, in an element container obtained earlier, or in an iframe, and returns a real frame reference.
- Validation code `RPA_NODE_INPUT_INVALID`


## Input references

| Field | Allowed forms |
|  --- | --- |
| `selectorType` | `literal`, `template` |
| `frame` | `literal`, `template` |
| `element` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `outputRange` | `literal`, `template` |
| `serialType` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `serialMin` | `literal`, `numericExpression` |
| `serialMax` | `literal`, `numericExpression` |
| `type` | `literal`, `template` |


## Outputs

**Mode** `outputRange` `eq` `"single"`

| Output field | Type or values |
|  --- | --- |
| `frame` | `FrameRef` |
| `matchedCount` | `number` |


**Mode** `outputRange` `eq` `"all"`

| Output field | Type or values |
|  --- | --- |
| `frame` | array<`FrameRef`> |
| `matchedCount` | `number` |


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

## JSON example

A complete node object for a workflow's `nodes` array or another node's `blocks`.

```json
{
  "id": "payment_frame",
  "type": "browser_getFrame",
  "data": {
    "title": "Get the payment iframe",
    "browserAction": "getFrame",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "iframe#payment",
        "outputRange": "single",
        "type": "contentFrame"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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