From 4f4a3dad0b2351c0d27262f2db6507a9773e33a3 Mon Sep 17 00:00:00 2001 From: Rui Figueira Date: Mon, 6 Apr 2026 09:06:39 +0100 Subject: [PATCH 1/6] [Browser Rendering] Add Wrangler browser commands documentation --- .../2026-04-06-browser-wrangler-commands.mdx | 36 +++++++++++++++++++ .../reference/wrangler-commands.mdx | 13 +++++++ .../workers/wrangler-commands/browser.mdx | 7 ++++ 3 files changed, 56 insertions(+) create mode 100644 src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx create mode 100644 src/content/docs/browser-rendering/reference/wrangler-commands.mdx create mode 100644 src/content/partials/workers/wrangler-commands/browser.mdx diff --git a/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx b/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx new file mode 100644 index 000000000000000..0cbc1189c5ca59c --- /dev/null +++ b/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx @@ -0,0 +1,36 @@ +--- +title: Manage Browser Rendering sessions with Wrangler CLI +description: Use the wrangler browser command namespace to manage Browser Rendering sessions from the CLI. +products: + - browser-rendering +date: 2026-04-06 +--- + +[Browser Rendering](/browser-rendering/) now supports a `wrangler browser` command namespace. Use it to manage live browser sessions directly from the command line. + +The following commands are available: + +| Command | Description | +| ------------------------- | -------------------------------------- | +| `wrangler browser create` | Create a new live 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 launches a new browser session and opens it in your default browser: + +```sh +wrangler browser create +``` + +Use `--lab` to enable lab browser features, or `--keepAlive` to set the session keep-alive duration (60-600 seconds): + +```sh +wrangler browser create --lab --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 that scripts and AI agents can parse directly. + +For full usage details, refer to the [Wrangler commands documentation](/browser-rendering/reference/wrangler-commands/). diff --git a/src/content/docs/browser-rendering/reference/wrangler-commands.mdx b/src/content/docs/browser-rendering/reference/wrangler-commands.mdx new file mode 100644 index 000000000000000..9e4a9e59f41cc66 --- /dev/null +++ b/src/content/docs/browser-rendering/reference/wrangler-commands.mdx @@ -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 the `wrangler browser` command namespace to manage Browser Rendering sessions from the command line. + + diff --git a/src/content/partials/workers/wrangler-commands/browser.mdx b/src/content/partials/workers/wrangler-commands/browser.mdx new file mode 100644 index 000000000000000..426ddd63727c9bc --- /dev/null +++ b/src/content/partials/workers/wrangler-commands/browser.mdx @@ -0,0 +1,7 @@ +--- +{} +--- + +import { WranglerNamespace } from "~/components"; + + From 5f4225192e5635cb444093f5e58d54276a7c3e19 Mon Sep 17 00:00:00 2001 From: Rui Figueira Date: Tue, 14 Apr 2026 10:32:56 +0100 Subject: [PATCH 2/6] [Browser Rendering] Add Wrangler browser commands reference page --- .../docs/workers/wrangler/commands/browser.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 src/content/docs/workers/wrangler/commands/browser.mdx diff --git a/src/content/docs/workers/wrangler/commands/browser.mdx b/src/content/docs/workers/wrangler/commands/browser.mdx new file mode 100644 index 000000000000000..f1ca72e304c380b --- /dev/null +++ b/src/content/docs/workers/wrangler/commands/browser.mdx @@ -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 [Browser Rendering](/browser/) service using Wrangler. + + From 6a62eb76dad01803e9f0143414d77f62c3d1630a Mon Sep 17 00:00:00 2001 From: kathayl Date: Tue, 14 Apr 2026 09:54:06 -0700 Subject: [PATCH 3/6] Simplify wording and add release note - Remove 'namespace' terminology from wrangler-commands page and changelog - Remove 'live' and '--lab' references from changelog - Improve changelog intro wording - Add wrangler commands entry to release notes YAML --- .../2026-04-06-browser-wrangler-commands.mdx | 10 +++++----- .../browser-rendering/reference/wrangler-commands.mdx | 2 +- src/content/release-notes/browser-rendering.yaml | 4 ++++ 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx b/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx index 0cbc1189c5ca59c..33fa611588ff7d1 100644 --- a/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx +++ b/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx @@ -1,18 +1,18 @@ --- title: Manage Browser Rendering sessions with Wrangler CLI -description: Use the wrangler browser command namespace to manage Browser Rendering sessions from the CLI. +description: Use wrangler browser commands to manage Browser Rendering sessions from the CLI. products: - browser-rendering date: 2026-04-06 --- -[Browser Rendering](/browser-rendering/) now supports a `wrangler browser` command namespace. Use it to manage live browser sessions directly from the command line. +[Browser Rendering](/browser-rendering/) now supports `wrangler browser` commands, letting you create, manage, and view browser sessions directly from your terminal, streamlining your workflow. The following commands are available: | Command | Description | | ------------------------- | -------------------------------------- | -| `wrangler browser create` | Create a new live browser session | +| `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 | @@ -23,10 +23,10 @@ The `create` command launches a new browser session and opens it in your default wrangler browser create ``` -Use `--lab` to enable lab browser features, or `--keepAlive` to set the session keep-alive duration (60-600 seconds): +Use `--keepAlive` to set the session keep-alive duration (60-600 seconds): ```sh -wrangler browser create --lab --keepAlive 300 +wrangler browser create --keepAlive 300 ``` The `view` command auto-selects when only one session exists, or prompts for selection when multiple sessions are available. diff --git a/src/content/docs/browser-rendering/reference/wrangler-commands.mdx b/src/content/docs/browser-rendering/reference/wrangler-commands.mdx index 9e4a9e59f41cc66..cd1f82bc88b6dcd 100644 --- a/src/content/docs/browser-rendering/reference/wrangler-commands.mdx +++ b/src/content/docs/browser-rendering/reference/wrangler-commands.mdx @@ -8,6 +8,6 @@ description: Manage Browser Rendering sessions from the command line using Wrang import { Render } from "~/components"; -Use the `wrangler browser` command namespace to manage Browser Rendering sessions from the command line. +Use `wrangler browser` commands to manage Browser Rendering sessions from the command line. diff --git a/src/content/release-notes/browser-rendering.yaml b/src/content/release-notes/browser-rendering.yaml index 27a8a990c99b268..fca7b731735bc61 100644 --- a/src/content/release-notes/browser-rendering.yaml +++ b/src/content/release-notes/browser-rendering.yaml @@ -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: |- From 9267098bf0090d35107573b4cc7916bfa2944db6 Mon Sep 17 00:00:00 2001 From: kathayl Date: Tue, 14 Apr 2026 09:59:47 -0700 Subject: [PATCH 4/6] Update changelog date to April 14th - Rename changelog file from 2026-04-06 to 2026-04-14 - Update frontmatter date to 2026-04-14 --- ...er-commands.mdx => 2026-04-14-browser-wrangler-commands.mdx} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename src/content/changelog/browser-rendering/{2026-04-06-browser-wrangler-commands.mdx => 2026-04-14-browser-wrangler-commands.mdx} (98%) diff --git a/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx b/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx similarity index 98% rename from src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx rename to src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx index 33fa611588ff7d1..84e48bd2d975410 100644 --- a/src/content/changelog/browser-rendering/2026-04-06-browser-wrangler-commands.mdx +++ b/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx @@ -3,7 +3,7 @@ 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-06 +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. From 0a0426b7cf25a4ef423d1c7cfb2a8519b6dc339b Mon Sep 17 00:00:00 2001 From: Kathy <153706637+kathayl@users.noreply.github.com> Date: Tue, 14 Apr 2026 10:59:18 -0700 Subject: [PATCH 5/6] Update src/content/docs/workers/wrangler/commands/browser.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- src/content/docs/workers/wrangler/commands/browser.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/workers/wrangler/commands/browser.mdx b/src/content/docs/workers/wrangler/commands/browser.mdx index f1ca72e304c380b..5259b4af8cec25d 100644 --- a/src/content/docs/workers/wrangler/commands/browser.mdx +++ b/src/content/docs/workers/wrangler/commands/browser.mdx @@ -6,6 +6,6 @@ description: Wrangler commands for interacting with Cloudflare Browser Rendering import { WranglerNamespace } from "~/components"; -Interact with [Browser Rendering](/browser/) service using Wrangler. +Interact with the [Browser Rendering](/browser-rendering/) service using Wrangler. From 76a80d6d44d5a24c965ee1ee3697ca08f3948c42 Mon Sep 17 00:00:00 2001 From: kathayl Date: Tue, 14 Apr 2026 16:30:34 -0700 Subject: [PATCH 6/6] Improve wrangler commands changelog per review feedback - Explain what sessions are and what you do after creating one - Add CDP, Puppeteer, Playwright, and MCP client links - Note that Wrangler handles auth (no API tokens needed) - Mention scriptability for automation --- .../2026-04-14-browser-wrangler-commands.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx b/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx index 84e48bd2d975410..3bcefc553209a05 100644 --- a/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx +++ b/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx @@ -6,7 +6,7 @@ products: 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. +[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: @@ -17,7 +17,7 @@ The following commands are available: | `wrangler browser list` | List active sessions | | `wrangler browser view` | View a live browser session | -The `create` command launches a new browser session and opens it in your default browser: +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 @@ -31,6 +31,6 @@ 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 that scripts and AI agents can parse directly. +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/).