From 0bc296e8800e219a02f5d026a6a331ea1dc0506c Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Fri, 7 Aug 2026 00:50:16 +0000
Subject: [PATCH 1/4] Add kiosk mode as first viewport recommendation

---
 browsers/viewport.mdx | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/browsers/viewport.mdx b/browsers/viewport.mdx
index 9d49143..3175ad4 100644
--- a/browsers/viewport.mdx
+++ b/browsers/viewport.mdx
@@ -141,6 +141,26 @@ The `viewport` parameter sets the dimensions of the browser **window**, not the
 
 If your automation expects an exact page viewport, either:
 
+- **Use kiosk mode** to remove the browser UI, so the window dimensions match the page viewport exactly. Pass `--kiosk` in `launch_args`:
+
+<CodeGroup>
+
+```typescript Typescript/Javascript
+const kernelBrowser = await kernel.browsers.create({
+  launch_args: ["--kiosk"],
+  viewport: { width: 1920, height: 1080 }
+});
+```
+
+```python Python
+kernel_browser = kernel.browsers.create(
+    launch_args=["--kiosk"],
+    viewport={"width": 1920, "height": 1080}
+)
+```
+
+</CodeGroup>
+
 - **Set the page viewport through your automation framework**, which controls the rendered page size directly regardless of the window dimensions:
 
 <CodeGroup>

From a0389e7198a83a67b0ea3c8b59118512b7b07988 Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Fri, 7 Aug 2026 00:52:58 +0000
Subject: [PATCH 2/4] Fix kiosk mode parameter: use kiosk_mode not launch_args

---
 browsers/viewport.mdx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/browsers/viewport.mdx b/browsers/viewport.mdx
index 3175ad4..dbb5a99 100644
--- a/browsers/viewport.mdx
+++ b/browsers/viewport.mdx
@@ -141,20 +141,20 @@ The `viewport` parameter sets the dimensions of the browser **window**, not the
 
 If your automation expects an exact page viewport, either:
 
-- **Use kiosk mode** to remove the browser UI, so the window dimensions match the page viewport exactly. Pass `--kiosk` in `launch_args`:
+- **Use kiosk mode** to remove the browser UI, so the window dimensions match the page viewport exactly. Set `kiosk_mode` to `true`:
 
 <CodeGroup>
 
 ```typescript Typescript/Javascript
 const kernelBrowser = await kernel.browsers.create({
-  launch_args: ["--kiosk"],
+  kiosk_mode: true,
   viewport: { width: 1920, height: 1080 }
 });
 ```
 
 ```python Python
 kernel_browser = kernel.browsers.create(
-    launch_args=["--kiosk"],
+    kiosk_mode=True,
     viewport={"width": 1920, "height": 1080}
 )
 ```

From 8ab649d3159083842957fbd625c908c61bbdb240 Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Fri, 7 Aug 2026 00:53:43 +0000
Subject: [PATCH 3/4] Remove redundant SDK param mention from kiosk mode bullet

---
 browsers/viewport.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/browsers/viewport.mdx b/browsers/viewport.mdx
index dbb5a99..0b9d496 100644
--- a/browsers/viewport.mdx
+++ b/browsers/viewport.mdx
@@ -141,7 +141,7 @@ The `viewport` parameter sets the dimensions of the browser **window**, not the
 
 If your automation expects an exact page viewport, either:
 
-- **Use kiosk mode** to remove the browser UI, so the window dimensions match the page viewport exactly. Set `kiosk_mode` to `true`:
+- **Use kiosk mode** to remove the browser UI, so the window dimensions match the page viewport exactly:
 
 <CodeGroup>
 

From 8b27c2f7b052630e2414658066253c0f3be3ccca Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Fri, 7 Aug 2026 01:02:41 +0000
Subject: [PATCH 4/4] Clarify second bullet explains rendered size not
 reflected in live view

---
 browsers/viewport.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/browsers/viewport.mdx b/browsers/viewport.mdx
index 0b9d496..0c8ecd2 100644
--- a/browsers/viewport.mdx
+++ b/browsers/viewport.mdx
@@ -161,7 +161,7 @@ kernel_browser = kernel.browsers.create(
 
 </CodeGroup>
 
-- **Set the page viewport through your automation framework**, which controls the rendered page size directly regardless of the window dimensions:
+- **Set the page viewport through your automation framework.** This will update the rendered page size, but will not be reflected in the live view or computer controls:
 
 <CodeGroup>