diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md
index 09a89027ba..37307cf5d3 100644
--- a/docs/src/api/class-page.md
+++ b/docs/src/api/class-page.md
@@ -2841,7 +2841,7 @@ are resolved relative to the the current working directory. For empty array, cle
 In the case of multiple pages in a single browser, each page can have its own viewport size. However,
 [`method: Browser.newContext`] allows to set viewport size (and more) for all pages in the context at once.
 
-`page.setViewportSize` will resize the page. A lot of websites don't expect phones to change size, so you should set the
+[`method: Page.setViewportSize`] will resize the page. A lot of websites don't expect phones to change size, so you should set the
 viewport size before navigating to the page. [`method: Page.setViewportSize`] will also reset `screen` size, use [`method: Browser.newContext`] with `screen` and `viewport` parameters if you need better control of these properties.
 
 ```js
diff --git a/docs/src/emulation.md b/docs/src/emulation.md
index a3b2b059a0..7615ed5a1e 100644
--- a/docs/src/emulation.md
+++ b/docs/src/emulation.md
@@ -167,7 +167,7 @@ context = await browser.new_context(
 )
 
 # Resize viewport for individual page
-await page.set_viewport_size(width=1600, height=1200)
+await page.set_viewport_size({"width": 1600, "height": 1200})
 
 # Emulate high-DPI
 context = await browser.new_context(
@@ -183,7 +183,7 @@ context = browser.new_context(
 )
 
 # Resize viewport for individual page
-page.set_viewport_size(width=1600, height=1200)
+await page.set_viewport_size({"width": 1600, "height": 1200})
 
 # Emulate high-DPI
 context = browser.new_context(
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 886854e9d2..05b521b977 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -3204,11 +3204,12 @@ export interface Page {
    * [browser.newContext([options])](https://playwright.dev/docs/api/class-browser#browser-new-context) allows to set
    * viewport size (and more) for all pages in the context at once.
    *
-   * `page.setViewportSize` will resize the page. A lot of websites don't expect phones to change size, so you should set the
-   * viewport size before navigating to the page.
-   * [page.setViewportSize(viewportSize)](https://playwright.dev/docs/api/class-page#page-set-viewport-size) will also reset
-   * `screen` size, use [browser.newContext([options])](https://playwright.dev/docs/api/class-browser#browser-new-context)
-   * with `screen` and `viewport` parameters if you need better control of these properties.
+   * [page.setViewportSize(viewportSize)](https://playwright.dev/docs/api/class-page#page-set-viewport-size) will resize the
+   * page. A lot of websites don't expect phones to change size, so you should set the viewport size before navigating to the
+   * page. [page.setViewportSize(viewportSize)](https://playwright.dev/docs/api/class-page#page-set-viewport-size) will also
+   * reset `screen` size, use
+   * [browser.newContext([options])](https://playwright.dev/docs/api/class-browser#browser-new-context) with `screen` and
+   * `viewport` parameters if you need better control of these properties.
    *
    * ```js
    * const page = await browser.newPage();