Tab Management

The Tab Management node controls browser tabs, allowing you to open new tabs, switch between tabs, and close tabs.

Parameters

Parameter	Type	Required	Description
`tabAction`	string	Yes	Action to perform: `OPEN`, `CLOSE`, or `SWITCH`
`url`	string	No	URL to open (required for `OPEN` action)
`tab_index`	number	No	Index of tab to switch to or close (0-based)
`wait_time`	number	No	Milliseconds to wait for the tab (defaults to `15000` for `SWITCH`)

Tab Actions

OPEN

Opens a new browser tab with the specified URL. By default the node returns as soon as the tab is created, without waiting for its content. Set wait_time to block until the new tab has finished loading — useful for slow documents such as large PDFs, where the next node would otherwise start against a blank page.

SWITCH

Switches focus to a tab at the specified index, waiting up to wait_time (15 seconds by default) for that tab to appear. Raise it when the tab is opened by the page itself and can take a while to show up.

CLOSE

Closes a tab at the specified index (or current tab if not specified).

Examples

Open New Tab

Open a new tab with a URL:

{
  "id": "3f2b8c1e-7a4d-4e9b-9c6f-1d2e3f4a5b6c",
  "name": "Open settings in new tab",
  "action": "TAB_MANAGEMENT",
  "parameters": {
    "tabAction": "OPEN",
    "url": "https://app.example.com/settings"
  }
}

Open Tab with Dynamic URL

Use variables in the URL:

{
  "id": "3f2b8c1e-7a4d-4e9b-9c6f-1d2e3f4a5b6c",
  "name": "Open user profile",
  "action": "TAB_MANAGEMENT",
  "parameters": {
    "tabAction": "OPEN",
    "url": "https://app.example.com/users/{{context.inputs.user_id}}"
  }
}

Switch to Tab

Switch to a specific tab by index:

{
  "id": "3f2b8c1e-7a4d-4e9b-9c6f-1d2e3f4a5b6c",
  "name": "Switch to first tab",
  "action": "TAB_MANAGEMENT",
  "parameters": {
    "tabAction": "SWITCH",
    "tab_index": 0
  }
}

Wait for a Slow Tab to Load

Give a slow-loading document up to 90 seconds before continuing:

{
  "id": "3f2b8c1e-7a4d-4e9b-9c6f-1d2e3f4a5b6c",
  "name": "Open patient PDF",
  "action": "TAB_MANAGEMENT",
  "parameters": {
    "tabAction": "OPEN",
    "url": "https://app.example.com/patients/{{context.inputs.patient_id}}.pdf",
    "wait_time": 90000
  }
}

Close Current Tab

Close the currently active tab:

{
  "id": "3f2b8c1e-7a4d-4e9b-9c6f-1d2e3f4a5b6c",
  "name": "Close current tab",
  "action": "TAB_MANAGEMENT",
  "parameters": {
    "tabAction": "CLOSE"
  }
}

Notes

Tab indices are 0-based (first tab is index 0)
When opening a new tab, focus automatically switches to the new tab
Closing the last remaining workflow tab is rejected because it would destroy the browser window and end the session
wait_time is in milliseconds and is a maximum, not a fixed delay — the node continues as soon as the tab is ready
Omitting wait_time, or setting it to 0, is treated as unset: SWITCH falls back to the 15 second default, and OPEN returns as soon as the tab is created without waiting for its content
wait_time bounds the tab itself. The node that interacts with the loaded page has its own wait_time for the element it targets, and that one also needs raising if the page renders slowly

Getting Started

Concepts

API Reference

SDK

Integrations

Parameters

Tab Actions

OPEN

SWITCH

CLOSE

Examples

Open New Tab

Open Tab with Dynamic URL

Switch to Tab

Wait for a Slow Tab to Load

Close Current Tab

Notes

​Parameters

​Tab Actions

​OPEN

​SWITCH

​CLOSE

​Examples

​Open New Tab

​Open Tab with Dynamic URL

​Switch to Tab

​Wait for a Slow Tab to Load

​Close Current Tab

​Notes

Parameters

Tab Actions

OPEN

SWITCH

CLOSE

Examples

Open New Tab

Open Tab with Dynamic URL

Switch to Tab

Wait for a Slow Tab to Load

Close Current Tab

Notes