---
title: "Viewports"
description: "Browser viewport."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Viewports

<p>Set <code>browserSettings.viewport</code> when creating a session. Use positive integer width and height within the published schema limits.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Idempotency-Key: tooluse-example-001" \
  -H "Content-Type: application/json" \
  -d '{"timeout":300,"browserSettings":{"viewport":{"width":1280,"height":720}}}'
</code></pre>
<p>The viewport applies to the remote Chromium page. Resizing your local browser window or live-view frame does not change the remote page viewport. A CDP client can change page emulation for its own automation.</p>

Source: https://help.tooluse.net/browsers/core-features/viewports/index.mdx