---
title: Change the desktop resolution with Puppeteer | TestingBot
description: Set the desktop screen resolution for Puppeteer tests on TestingBot.
  Choose from common resolutions (1920x1080, 1280x1024, etc.) via the screenResolution
  capability when connecting to the cloud.
source_url:
  html: https://testingbot.com/support/web-automate/puppeteer/change-screen-resolution
  md: https://testingbot.com/support/web-automate/puppeteer/change-screen-resolution.md
---

# Change desktop screen resolution with Puppeteer

The TestingBot Desktop VMs (Windows, macOS and Linux) all support changing the screen-resolution before a test starts.

We currently support the following screen resolutions:

 Value Type | Default Value | || string | "1280x1024" | Platform \| Resolutions \|\| Windows/Linux \| - 800x600 - 1024x768 - 1152x864 - 1280x768 - 1280x800 - 1280x960 - 1280x1024 - 1400x1050 - 1600x1200 - 1680x1050 - 1920x1080 - 1920x1200 - 2560x1440 \| \| macOS \| - 800x600 - 1024x768 - 1280x768 - 1280x800 - 1280x960 - 1280x1024 - 1366x768 - 1440x900 - 1600x900 - 1600x1200 - 1680x1050 - 1920x1080 - 1920x1200 - 2048x1536 \| |

To change the screen resolution, please specify the `screen-resolution` parameter in the `browserWSEndpoint` URL.

```javascript
const puppeteer = require('puppeteer-core')
const capabilities = {
    'tb:options': {
        key: process.env.TB_KEY,
        secret: process.env.TB_SECRET
    },
    browserName: 'chrome',
    browserVersion: 'latest',
    'screen-resolution': '1600x900'
}

;(async () => {
  const browser = await puppeteer.connect({
    browserWSEndpoint: `wss://cloud.testingbot.com/puppeteer?capabilities=${encodeURIComponent(JSON.stringify(capabilities))}`
  })

  const page = await browser.newPage()
  await page.goto('https://testingbot.com')
  await page.screenshot({ path: 'screenshot.png' })
  await browser.close()
})()
```

Changing the screen resolution does not resize the viewport. To change the viewport with Puppeteer, please use `page.setViewport`.

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

[Email us](https://testingbot.com/contact/new) [Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)