Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: Manage Browser Rendering sessions with Wrangler CLI
description: Use wrangler browser commands to manage Browser Rendering sessions from the CLI.
products:
- browser-rendering
date: 2026-04-14
---

[Browser Rendering](/browser-rendering/) now supports `wrangler browser` commands, letting you create, manage, and view browser sessions directly from your terminal, streamlining your workflow. Since Wrangler handles authentication, you do not need to pass API tokens in your commands.

The following commands are available:

| Command | Description |
| ------------------------- | -------------------------------------- |
| `wrangler browser create` | Create a new browser session |
| `wrangler browser close` | Close a session |
| `wrangler browser list` | List active sessions |
| `wrangler browser view` | View a live browser session |

The `create` command spins up a browser instance on Cloudflare's network and returns a session URL. Once created, you can connect to the session using any [CDP](/browser-rendering/cdp/)-compatible client like [Puppeteer](/browser-rendering/cdp/puppeteer/), [Playwright](/browser-rendering/cdp/playwright/), or [MCP clients](/browser-rendering/cdp/mcp-clients/) to automate browsing, scrape content, or debug remotely.

```sh
wrangler browser create
```

Use `--keepAlive` to set the session keep-alive duration (60-600 seconds):

```sh
wrangler browser create --keepAlive 300
```

The `view` command auto-selects when only one session exists, or prompts for selection when multiple sessions are available.

All commands support `--json` for structured output, and because these are CLI commands, you can incorporate them into scripts to automate session management.

For full usage details, refer to the [Wrangler commands documentation](/browser-rendering/reference/wrangler-commands/).
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
pcx_content_type: reference
title: Wrangler commands
sidebar:
order: 21
description: Manage Browser Rendering sessions from the command line using Wrangler.
---

import { Render } from "~/components";

Use `wrangler browser` commands to manage Browser Rendering sessions from the command line.

<Render file="wrangler-commands/browser" product="workers" />
11 changes: 11 additions & 0 deletions src/content/docs/workers/wrangler/commands/browser.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
pcx_content_type: reference
title: Browser
description: Wrangler commands for interacting with Cloudflare Browser Rendering.
---

import { WranglerNamespace } from "~/components";

Interact with the [Browser Rendering](/browser-rendering/) service using Wrangler.

<WranglerNamespace namespace="browser" />
7 changes: 7 additions & 0 deletions src/content/partials/workers/wrangler-commands/browser.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
{}
---

import { WranglerNamespace } from "~/components";

<WranglerNamespace namespace="browser" />
4 changes: 4 additions & 0 deletions src/content/release-notes/browser-rendering.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@ link: "/browser-rendering/changelog/"
productName: Browser Rendering
productLink: "/browser-rendering/"
entries:
- publish_date: "2026-04-14"
title: "Wrangler CLI commands for Browser Rendering"
description: |-
* Added `wrangler browser` commands to create, manage, and view browser sessions directly from the terminal. Available commands: `create`, `close`, `list`, and `view`. For full usage details, refer to [Wrangler commands](/browser-rendering/reference/wrangler-commands/).
- publish_date: "2026-04-13"
title: "@cloudflare/puppeteer v1.1.0 released"
description: |-
Expand Down
Loading