Viewport Size

Use test settings to run a web test at a different browser viewport size. The viewport is fixed before the run starts; the agent cannot resize the browser, page, screen, window, or viewport from inside a test step.

Change Viewport Size

1. Open the project that contains the test.
2. Open the test you want to run at a different size.
3. Open Test settings.
4. Select Viewport Size.
5. Save the test.
6. Run the test again.

The selected viewport applies to future runs of that test. Existing runs keep the viewport they started with.

Writing Test Steps

Do not add steps such as “resize the page to mobile” or “change the browser to 390px wide”. Instead, configure the test viewport first, then write steps that describe the user behavior to verify at that size.

If a run fails with VIEWPORT_RESIZE_UNSUPPORTED, update the test settings and retry the run.