Skip to main content

Overview

Viewports define the screen dimensions and browser configurations the Spur Agent uses when running tests. By testing with the same viewport settings your customers use, you ensure accurate visual regression detection and functional validation across devices.
Key Benefit: With Spur, you can run the same test across multiple viewports simultaneously if your test uses intent-based instructions rather than pixel-specific coordinates.

Configure Viewport Settings

When creating a test, scroll to Viewport Settings and choose Desktop, Mobile, or both.
1

Create a New Test

Step1viewport 1
2

Scroll to Viewport Settings

Step2viewport 1
3

Choose from Desktop and Mobile Web Viewports

Test can be configured to run on both desktop and mobile viewports as well.
Screenshot 2026 02 12 At 12 01 20 PM
4

Choose Dimensions

Presets for Desktop Testing:

  • MacBook Pro 15” (1440×900)
  • MacBook Pro 16” (1536×960)
  • MacBook Pro 13” (1280×800)
  • iPad Pro (1024×1366)
  • Custom

Presets for Mobile testing:

  • iPhone 14 Pro Max (430×932)
  • iPhone 14 (390×844)
  • Samsung Galaxy S24 UI
  • Samsung Galaxy S23 UI
  • Google Pixel 8 Pro (412×915)
  • Google Pixel 7 Pro (412×915)
  • Custom
You can create custom viewport dimensions as well.
Screenshot 2026 02 12 At 11 52 22 AM
5

Set User Agent

For Desktop:
Mozilla/5.0 (iPhone; Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.6478.61 Safari/537.36 SpurtesterCPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.2 Mobile/15E148 Safari/604.1 Spurtester
For Mobile:
Mozilla/5.0 (iPhone; Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.6478.61 Safari/537.36 SpurtesterCPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.2 Mobile/15E148 Safari/604.1 Spurtester
6

Save your test

After saving, tests configured with multiple viewports display both desktop and mobile icons in the Test Type column, making it easy to identify cross-device tests at a glance.
Group4

Testing Multiple Viewports

When you select both Desktop and Mobile viewports, Spur runs your test twice: once for each configuration. This is particularly valuable for responsive design testing.
When testing multiple viewports, your test will consume 2 test runs. Each viewport configuration counts as a separate execution.
When you’re ready to run a test with multiple viewports configured, see how to select which viewports to include in the Run Modal. This approach ensures that responsive design issues, mobile-specific bugs,and viewport-dependent behavior are caught before reaching production.
Group2