Runs onWrit CloudDesktopSelf-hosted
On this page
Switch tab
The switch_tab step changes which open tab the following steps act on, addressed by its position among the open tabs.
In a workflow, this is a step object with "type": "switch_tab". Steps run in order, and each step can read the outputs of the steps before it. See the full workflows reference for the 30+ step types.
Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
Fields
| Field | Type | Description |
|---|---|---|
tab_index required | number | Zero-based index of the tab to activate. |
Example
A single switch_tab step as it appears in a workflow's steps array:
{
"type": "switch_tab",
"config": { "tab_index": 0 }
}How it behaves
- An out-of-range index fails the step with the tab count in the message.
- Pairs with open_tab and tab_closed in multi-tab flows.
Where it runs
The switch_tab step executes wherever the run executes. On your local or BYO agent there is no compute charge and the agent can reach intranet-only systems; on Writ cloud the run is metered by running time (~$0.12 per browser-hour, from your plan’s included usage wallet.
What next
- Workflows - the full step vocabulary and the workflow object.
- Recorder - capture steps by clicking through a site.
- Managed endpoints - turn the workflow into a REST endpoint, or an MCP tool.