> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/starter/open.md).

# Open

Open a URL to start every Test Case, and choose the browser or Simulated Device.

Open is the first [Test Step](/getting-started/terminology.md) in every Flow. It starts the browser (or [Simulated Device](/getting-started/terminology.md)), loads your URL, and sets the environment for every step that follows.

Use Open when a Test Case needs a fresh page. Use [Go to absolute URL](/test-steps/browser/go-to-absolute-url.md) or [Go to relative path](/test-steps/browser/go-to-relative-path.md) later in the Flow when you need to move to another address without restarting the browser.

![Open Test Step](https://static.does.qa/assets/nodes/starter_open.png)

## When to use it

* Start every Flow with Open so each Test Case has a clear entry URL.
* Choose **Simulated Device** when you need a named phone or tablet preset (viewport, user agent, and touch).
* Prefer Chrome, Firefox, or Edge with a Desktop or Tablet Variant for ordinary desktop and tablet layouts.

## Configure

### Basics

| Field       | What to set                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------------- |
| **URL**     | Fully qualified address, or a [Value](/values/value-store.md) that expands to one                   |
| **Runner**  | `Chrome` (default), `Firefox`, `Edge`, or `Simulated Device`                                        |
| **Variant** | Desktop and tablet sizes for Chrome/Firefox/Edge, or a named device when Runner is Simulated Device |

<details>

<summary>Available Variants and Simulated Devices</summary>

The Variant list changes based on the Runner you choose.

**Chrome:**

* Chrome: Desktop (1920×1080, default)
* Chrome: Desktop - Ultra-wide (2560×1080)
* Chrome: Desktop - Portrait (1080×1920)
* Chrome: Tablet - Landscape (1024×768)
* Chrome: Tablet - Portrait (768×1024)

**Firefox:**

* Firefox: Desktop (1920×1080)
* Firefox: Desktop - Ultra-wide (2560×1080)
* Firefox: Desktop - Portrait (1080×1920)
* Firefox: Tablet - Landscape (1024×768)
* Firefox: Tablet - Portrait (768×1024)

**Edge:**

* Edge: Desktop (1920×1080)
* Edge: Desktop - Ultra-wide (2560×1080)
* Edge: Desktop - Portrait (1080×1920)
* Edge: Tablet - Landscape (1024×768)
* Edge: Tablet - Portrait (768×1024)

**Simulated Device (phones, tablets, and other devices):**

* iPhone 14 Pro Max
* iPhone 12 Pro
* iPhone XR
* iPhone X
* iPhone SE
* iPhone 4
* iPad Pro
* iPad Mini
* iPad Air
* Samsung Galaxy A51/71
* Galaxy Z Fold 5
* Samsung Galaxy S3
* Samsung Galaxy S8
* Samsung Galaxy S8+
* Samsung Galaxy S9+
* Samsung Galaxy S20 Ultra
* Samsung Galaxy Note 2
* Samsung Galaxy Note 3
* Samsung Galaxy Tab S4
* Microsoft Lumia 550
* Microsoft Lumia 950
* Moto G4
* Moto G Power
* Nokia N9
* Nexus 4
* Nexus 5
* Nexus 5X
* Nexus 6
* Nexus 6P
* Nexus 7
* Nexus 10
* Pixel 2
* Pixel 2 XL
* Pixel 3
* Pixel 3 XL
* Pixel 4
* Pixel 7
* Surface Duo
* Surface Pro 7
* Asus Zenbook Fold
* Blackberry Playbook
* Blackberry Z30
* Kindle Fire HDX
* LG Optimus L70
* Nest Hub
* Nest Hub Max

</details>

### Advanced

| Field                       | What to set                                          |
| --------------------------- | ---------------------------------------------------- |
| **Language**                | Browser language for the session                     |
| **Timezone**                | Timezone for the session (`UTC` by default)          |
| **Throttle**                | Network speed simulation, or `No throttle` (default) |
| **Basic Auth**              | Turn on when the site needs HTTP Basic Auth          |
| **Username** / **Password** | Credentials when Basic Auth is on (supports Values)  |
| **Authentication Mode**     | `URL` or `Header` for how Basic Auth is applied      |
| **Headers**                 | Extra request headers as JSON                        |

<details>

<summary>Available Languages</summary>

* English (United States) - default
* English (United Kingdom)
* Chinese (China, Simplified)
* Spanish (Spain)
* Spanish (Mexico)
* French (France)
* German (Germany)
* Japanese (Japan)
* Polish (Poland)
* Italian (Italy)
* Arabic (United Arab Emirates)

</details>

<details>

<summary>Available Timezones</summary>

* UTC - default
* America/New\_York
* Europe/London
* Europe/Paris
* America/Los\_Angeles
* Europe/Berlin
* Asia/Tokyo
* Australia/Sydney
* America/Sao\_Paulo
* Asia/Dubai

</details>

<details>

<summary>Available Throttle options</summary>

* **No throttle** (default) - No network speed limit
* **Fast Wifi** - Fast wireless connection
* **Slow Wifi** - Slow wireless connection
* **4G** - Mobile 4G speed
* **3G** - Mobile 3G speed
* **2G** - Mobile 2G speed
* **Offline** - No network connection

</details>

{% hint style="info" %}
**Pro tip:** Keep environment hosts in Assets Values (for example `$BASE_URL`) so one Flow can target staging and production without editing Open each time.
{% endhint %}

## Related

* [Simulated Device](/getting-started/terminology.md)
* [Whitelisting IPs](/configuration/whitelisting-ips.md)
* [Go to absolute URL](/test-steps/browser/go-to-absolute-url.md)
* [Condition](/test-steps/runner/condition.md)
* [Choose Flow Branch shapes](/better-coverage/choose-flow-branch-shapes.md)
* [Starter](/test-steps/starter.md)

**Tags:** `starter`, `open`, `goto`, `browser`, `navigate`, `simulated device`