---
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/index.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.

    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'
    }
    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`.

Was this page helpful? Yes No 

## Looking for More Help?

Have questions or need more information?   
 You can reach us via the following channels:

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