Rename Browser Rendering to Browser Run in user-facing strings (#13516)

jonnyparris · web-flow · commit 4eb1da9b2424 · 2026-04-15T20:40:46.000+01:00
diff --git a/.changeset/rename-browser-run.md b/.changeset/rename-browser-run.md
@@ -0,0 +1,7 @@
+---
+"wrangler": patch
+"miniflare": patch
+"@cloudflare/workers-utils": patch
+---
+
+Rename "Browser Rendering" to "Browser Run" in all user-facing strings, error messages, and CLI output.
diff --git a/packages/miniflare/README.md b/packages/miniflare/README.md
@@ -634,7 +634,7 @@ parameter in module format Workers.
 - `workflows?: WorkflowOptions[]`
   Configuration for one or more Workflows in your project.
 
-#### Browser Rendering
+#### Browser Run
 
 - `browserRendering: BrowserRenderingOptions`
 
diff --git a/packages/workers-utils/src/config/validation.ts b/packages/workers-utils/src/config/validation.ts
@@ -128,7 +128,7 @@ export const friendlyBindingNames: Record<ConfigBindingFieldName, string> = {
 	services: "Worker",
 	analytics_engine_datasets: "Analytics Engine Dataset",
 	text_blobs: "Text Blob",
-	browser: "Browser",
+	browser: "Browser Run",
 	ai: "AI",
 	images: "Images",
 	stream: "Stream",
@@ -164,7 +164,7 @@ const bindingTypeFriendlyNames: Record<Binding["type"], string> = {
 	send_email: "Send Email",
 	wasm_module: "Wasm Module",
 	text_blob: "Text Blob",
-	browser: "Browser",
+	browser: "Browser Run",
 	ai: "AI",
 	images: "Images",
 	stream: "Stream",
diff --git a/packages/workers-utils/src/environment-variables/factory.ts b/packages/workers-utils/src/environment-variables/factory.ts
@@ -108,7 +108,7 @@ type VariableNames =
 
 	/** Enable the local explorer UI at /cdn-cgi/explorer (experimental, default: false). */
 	| "X_LOCAL_EXPLORER"
-	/** Open the browser in headful (visible) mode when using the Browser Rendering API in local dev (default: false). */
+	/** Open the browser in headful (visible) mode when using the Browser Run API in local dev (default: false). */
 	| "X_BROWSER_HEADFUL"
 
 	// ## CI-specific Variables (Internal Use)
diff --git a/packages/workers-utils/src/environment-variables/misc-variables.ts b/packages/workers-utils/src/environment-variables/misc-variables.ts
@@ -348,7 +348,7 @@ export const getLocalExplorerEnabledFromEnv =
 
 /**
  * `X_BROWSER_HEADFUL` opens the browser in headful (visible) mode when using the
- * Browser Rendering API in local development.
+ * Browser Run API in local development.
  *
  * Set to "true" to enable:
  *
diff --git a/packages/wrangler/src/__tests__/browser-rendering.test.ts b/packages/wrangler/src/__tests__/browser-rendering.test.ts
@@ -43,7 +43,7 @@ describe("wrangler browser", () => {
 			http.get(
 				`*/accounts/:accountId/browser-rendering/devtools/session`,
 				() => {
-					// Browser Rendering API returns raw JSON, not wrapped in { success, result }
+					// Browser Run API returns raw JSON, not wrapped in { success, result }
 					return HttpResponse.json(sessions);
 				},
 				{ once: true }
@@ -59,7 +59,7 @@ describe("wrangler browser", () => {
 			http.get(
 				`*/accounts/:accountId/browser-rendering/devtools/browser/${sessionId}/json`,
 				() => {
-					// Browser Rendering API returns raw JSON, not wrapped in { success, result }
+					// Browser Run API returns raw JSON, not wrapped in { success, result }
 					return HttpResponse.json(targets);
 				},
 				{ once: true }
@@ -108,7 +108,7 @@ describe("wrangler browser", () => {
 				"
 				 ⛅️ wrangler x.x.x
 				──────────────────
-				No active browser rendering sessions found."
+				No active Browser Run sessions found."
 			`);
 		});
 
@@ -560,7 +560,7 @@ describe("wrangler browser", () => {
 				mockListSessions([]);
 
 				await expect(runWrangler("browser view")).rejects.toThrowError(
-					"No active browser rendering sessions found. Use `wrangler browser create` to create one."
+					"No active Browser Run sessions found. Use `wrangler browser create` to create one."
 				);
 			});
 
@@ -1002,7 +1002,7 @@ describe("wrangler browser", () => {
 
 			await expect(
 				runWrangler("browser close nonexistent")
-			).rejects.toThrowError("Browser Rendering API error: Session not found");
+			).rejects.toThrowError("Browser Run API error: Session not found");
 		});
 	});
 });
diff --git a/packages/wrangler/src/__tests__/deploy/durable-objects.test.ts b/packages/wrangler/src/__tests__/deploy/durable-objects.test.ts
@@ -860,7 +860,7 @@ describe("deploy", () => {
 				Worker Startup Time: 100 ms
 				Your Worker has access to the following bindings:
 				Binding               Resource
-				env.MYBROWSER         Browser
+				env.MYBROWSER         Browser Run
 				env.AI_BIND           AI
 
 				Uploaded test-name (TIMINGS)
diff --git a/packages/wrangler/src/__tests__/dev.test.ts b/packages/wrangler/src/__tests__/dev.test.ts
@@ -2609,7 +2609,7 @@ describe.sequential("wrangler dev", () => {
 		});
 	});
 
-	describe("`browser rendering binding", () => {
+	describe("`browser run binding", () => {
 		it("should not show error when running locally", async ({ expect }) => {
 			writeWranglerConfig({
 				browser: {
diff --git a/packages/wrangler/src/__tests__/index.test.ts b/packages/wrangler/src/__tests__/index.test.ts
@@ -50,7 +50,7 @@ describe("wrangler", () => {
 				COMPUTE & AI
 				  wrangler ai                     🤖 Manage AI models
 				  wrangler ai-search              🔍 Manage AI Search instances [open beta]
-				  wrangler browser                🌐 Manage Browser Rendering sessions [open beta]
+				  wrangler browser                🌐 Manage Browser Run sessions [open beta]
 				  wrangler containers             📦 Manage Containers
 				  wrangler delete [name]          🗑️ Delete a Worker from Cloudflare
 				  wrangler deploy [script]        🆙 Deploy a Worker to Cloudflare
@@ -127,7 +127,7 @@ describe("wrangler", () => {
 				COMPUTE & AI
 				  wrangler ai                     🤖 Manage AI models
 				  wrangler ai-search              🔍 Manage AI Search instances [open beta]
-				  wrangler browser                🌐 Manage Browser Rendering sessions [open beta]
+				  wrangler browser                🌐 Manage Browser Run sessions [open beta]
 				  wrangler containers             📦 Manage Containers
 				  wrangler delete [name]          🗑️ Delete a Worker from Cloudflare
 				  wrangler deploy [script]        🆙 Deploy a Worker to Cloudflare
diff --git a/packages/wrangler/src/__tests__/versions/versions.view.test.ts b/packages/wrangler/src/__tests__/versions/versions.view.test.ts
@@ -684,7 +684,7 @@ describe("versions view", () => {
 				env.SERVICE (worker)                                                     Worker
 				env.SERVICE_2 (worker#Enterypoint)                                       Worker
 				env.AE (datset)                                                          Analytics Engine Dataset
-				env.BROWSER                                                              Browser
+				env.BROWSER                                                              Browser Run
 				env.AI                                                                   AI
 				env.VERSION_METADATA                                                     Worker Version Metadata
 				env.WFP (wfp-namespace)                                                  Dispatch Namespace
diff --git a/packages/wrangler/src/browser-rendering/close.ts b/packages/wrangler/src/browser-rendering/close.ts
@@ -6,9 +6,9 @@ import type { BrowserCloseResponse } from "./types";
 
 export const browserCloseCommand = createCommand({
 	metadata: {
-		description: "Close a browser rendering session",
+		description: "Close a Browser Run session",
 		status: "open beta",
-		owner: "Product: Browser Rendering",
+		owner: "Product: Browser Run",
 	},
 	behaviour: {
 		printBanner: (args) => !args.json,
diff --git a/packages/wrangler/src/browser-rendering/create.ts b/packages/wrangler/src/browser-rendering/create.ts
@@ -12,9 +12,9 @@ const MAX_KEEP_ALIVE_SECONDS = 600;
 
 export const browserCreateCommand = createCommand({
 	metadata: {
-		description: "Create a new browser rendering session",
+		description: "Create a new Browser Run session",
 		status: "open beta",
-		owner: "Product: Browser Rendering",
+		owner: "Product: Browser Run",
 	},
 	behaviour: {
 		printBanner: (args) => !args.json,
diff --git a/packages/wrangler/src/browser-rendering/index.ts b/packages/wrangler/src/browser-rendering/index.ts
@@ -2,9 +2,9 @@ import { createNamespace } from "../core/create-command";
 
 export const browserNamespace = createNamespace({
 	metadata: {
-		description: "🌐 Manage Browser Rendering sessions",
+		description: "🌐 Manage Browser Run sessions",
 		status: "open beta",
-		owner: "Product: Browser Rendering",
+		owner: "Product: Browser Run",
 		category: "Compute & AI",
 	},
 });
diff --git a/packages/wrangler/src/browser-rendering/list.ts b/packages/wrangler/src/browser-rendering/list.ts
@@ -6,9 +6,9 @@ import type { BrowserSession } from "./types";
 
 export const browserListCommand = createCommand({
 	metadata: {
-		description: "List active browser rendering sessions",
+		description: "List active Browser Run sessions",
 		status: "open beta",
-		owner: "Product: Browser Rendering",
+		owner: "Product: Browser Run",
 	},
 	behaviour: {
 		printBanner: (args) => !args.json,
@@ -33,7 +33,7 @@ export const browserListCommand = createCommand({
 		}
 
 		if (sessions.length === 0) {
-			logger.log("No active browser rendering sessions found.");
+			logger.log("No active Browser Run sessions found.");
 			return;
 		}
 
diff --git a/packages/wrangler/src/browser-rendering/utils.ts b/packages/wrangler/src/browser-rendering/utils.ts
@@ -8,7 +8,7 @@ interface FetchOptions {
 }
 
 /**
- * Parse error message from Browser Rendering API response.
+ * Parse error message from Browser Run API response.
  */
 function parseErrorMessage(text: string): string {
 	try {
@@ -29,9 +29,9 @@ function parseErrorMessage(text: string): string {
 }
 
 /**
- * Fetch from the Browser Rendering Devtools API.
+ * Fetch from the Browser Run Devtools API.
  *
- * The Browser Rendering Devtools API returns raw JSON responses (not wrapped in the
+ * The Browser Run Devtools API returns raw JSON responses (not wrapped in the
  * standard Cloudflare API envelope with `success`, `result`, `errors` fields).
  * This function handles that difference.
  */
@@ -58,18 +58,18 @@ export async function fetchBrowserRendering<ResponseType>(
 	if (!response.ok) {
 		const errorMessage = parseErrorMessage(text);
 		throw new APIError({
-			text: `Browser Rendering API error: ${errorMessage}`,
+			text: `Browser Run API error: ${errorMessage}`,
 			notes: [{ text: `${method} ${url} -> ${response.status}` }],
 			status: response.status,
 		});
 	}
 
 	try {
-		// Browser Rendering API returns raw JSON, not wrapped in { success, result }
+		// Browser Run API returns raw JSON, not wrapped in { success, result }
 		return JSON.parse(text) as ResponseType;
 	} catch {
 		throw new APIError({
-			text: "Received a malformed response from the Browser Rendering API",
+			text: "Received a malformed response from the Browser Run API",
 			notes: [
 				{ text: text.length > 100 ? `${text.substring(0, 100)}...` : text },
 				{ text: `${method} ${url} -> ${response.status}` },
diff --git a/packages/wrangler/src/browser-rendering/view.ts b/packages/wrangler/src/browser-rendering/view.ts
@@ -82,7 +82,7 @@ export const browserViewCommand = createCommand({
 	metadata: {
 		description: "View a live browser session",
 		status: "open beta",
-		owner: "Product: Browser Rendering",
+		owner: "Product: Browser Run",
 	},
 	behaviour: {
 		printBanner: (args) => !args.json,
@@ -129,7 +129,7 @@ export const browserViewCommand = createCommand({
 
 			if (sessions.length === 0) {
 				throw new UserError(
-					"No active browser rendering sessions found. Use `wrangler browser create` to create one."
+					"No active Browser Run sessions found. Use `wrangler browser create` to create one."
 				);
 			}
 
diff --git a/packages/wrangler/src/core/teams.d.ts b/packages/wrangler/src/core/teams.d.ts
@@ -24,4 +24,4 @@ export type Teams =
 	| "Product: WVPC"
 	| "Product: Tunnels"
 	| "Product: Email Service"
-	| "Product: Browser Rendering";
+	| "Product: Browser Run";
diff --git a/packages/wrangler/src/index.ts b/packages/wrangler/src/index.ts
@@ -1744,7 +1744,7 @@ export function createCLIParser(argv: string[]) {
 	]);
 	registry.registerNamespace("ai");
 
-	// browser rendering
+	// browser run
 	registry.define([
 		{ command: "wrangler browser", definition: browserNamespace },
 		{ command: "wrangler browser create", definition: browserCreateCommand },
diff --git a/packages/wrangler/src/user/user.ts b/packages/wrangler/src/user/user.ts
@@ -385,7 +385,7 @@ const DefaultScopes = {
 		"See and change Email Routing settings, rules, and destination addresses.",
 	"email_sending:write":
 		"See and change Email Sending settings and configuration.",
-	"browser:write": "See and manage Browser Rendering sessions",
+	"browser:write": "See and manage Browser Run sessions",
 } as const;
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -348,7 +348,7 @@ export const getLocalExplorerEnabledFromEnv =`
`348`	`348`
`349`	`349`	`/**`
`350`	`350`	* `X_BROWSER_HEADFUL` opens the browser in headful (visible) mode when using the
`351`		`- * Browser Rendering API in local development.`
	`351`	`+ * Browser Run API in local development.`
`352`	`352`	`*`
`353`	`353`	`* Set to "true" to enable:`
`354`	`354`	`*`