---
title: Switch window
description: "Continue a web test in another tab or window: a payment page, an OAuth popup, a document preview. Every later step runs in that window."
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Continue the test in another tab or window: a payment page that opened in a new tab, an OAuth popup, a document preview. Every step after this one runs in the window you switched to.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Tab name or URL | Yes | Text matched against the title and URL of open tabs. The first matching tab becomes the active one. Supports variables. |
| Ignore error on this step | No | The run continues with the next step if no tab matches. Default: off. |

## Results and metrics

- **Timing**: start, end, and duration (in seconds) recorded in the step result.
- **Status**: failed if no open tab matches the name or URL.
- **Screenshot**: captured in the newly active tab.

## What's next?

<Columns cols={2}>
  <Card title="Verify element" icon="eye" href="/tests/actions/web/verifyelement">

    Confirm the new tab shows what you expect

</Card>
  <Card title="Navigate to URL" icon="globe" href="/tests/actions/web/navigatetourl">

    Load a different page in the current tab

</Card>
</Columns>