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 new file mode 100644 index 000000000000000..3bcefc553209a05 --- /dev/null +++ b/src/content/changelog/browser-rendering/2026-04-14-browser-wrangler-commands.mdx @@ -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/). 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..cd1f82bc88b6dcd --- /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 `wrangler browser` commands to manage Browser Rendering sessions from the command line. + + 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..5259b4af8cec25d --- /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 the [Browser Rendering](/browser-rendering/) service using Wrangler. + + 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"; + + 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: |-