cloudflare · Cloudflare Workers Docs

Workers Migrate from Wrangler v3 to v4

Provides instructions for upgrading the Wrangler CLI from version 3 to version 4, including handling breaking changes in Node.js support, esbuild versions, command defaults, and deprecated configurations.

Import to Prompt Buddy

Derived skill

Files assembled from official documentation

Viewing SKILL.md

Workers Migrate from Wrangler v3 to v4

When To Use

Use when upgrading a Cloudflare Workers project from Wrangler v3 to v4 to ensure compatibility with new Node.js requirements and command-line defaults.

Reference Files

What This Skill Covers

Wrangler v4 is a major release focused on updates to underlying systems and dependencies, along with improvements to keep Wrangler commands consistent and cl...
Main sections: Upgrade to Wrangler v4, Summary of changes, Detailed Changes, Updated Node.js support policy, Upgraded esbuild version.

Workflow

Open the most relevant file under docs/ for the exact documented workflow and wording.
Open schemas/ files for exact structured contracts.
Open examples/ files for concrete requests, commands, snippets, and manifests.
Do not add behavior or configuration that is not present in the attached source files.

Canonical source: https://developers.cloudflare.com/workers/wrangler/migration/update-v3-to-v4/index.md

Skill metadata

Name: Workers Migrate from Wrangler v3 to v4
Author: Bruno HANSS - Prompt Buddy
Generation mode: Ai Assisted Human Authored
Source count: 1

Provenance

Source program: Cloudflare Workers Docs
Last generated: May 10, 2026
Last source sync: Unknown
Source pages: 1

Safety model

Canonical source pages are preserved separately. Derived files record source evidence and require zero AI-generated facts.

File tree

Source links

https://developers.cloudflare.com/workers/wrangler/migration/update-v3-to-v4/index.md Back to skills

File	Contains	Use For
`SKILL.md`	Entry point: scope, routing table, and workflow.	Start here.
`docs/workers-wrangler-migration-migrate-from-v3-to-v4-workflow-guide.md`	A guide detailing the major changes, command updates, and Node.js support policy transitions required to upgrade from Wrangler v3 to v4.	Questions about a guide detailing the major changes, command updates, and Node.js support policy transitions required to upgrade from...
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran.text`	The npm command required to install wrangler version 4 as a development dependency.	Exact payloads, commands, or snippets shown in The npm command required to install wrangler version 4 as a development dependency.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-2.text`	The shell command to upgrade the wrangler package to version 4 using yarn.	Exact payloads, commands, or snippets shown in The shell command to upgrade the wrangler package to version 4 using yarn.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-3.text`	The pnpm command used to install wrangler version 4 as a development dependency.	Exact payloads, commands, or snippets shown in The pnpm command used to install wrangler version 4 as a development dependency.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-4.text`	The shell command to upgrade the wrangler package to version 4 using the bun package manager.	Exact payloads, commands, or snippets shown in The shell command to upgrade the wrangler package to version 4 using the bun package manager.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-5.text`	A command to check the current installed version of the Wrangler CLI using npx.	Exact payloads, commands, or snippets shown in A command to check the current installed version of the Wrangler CLI using npx.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-6.text`	A command to check the current installed version of the Wrangler CLI using yarn.	Exact payloads, commands, or snippets shown in A command to check the current installed version of the Wrangler CLI using yarn.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-7.text`	A command to check the current installed version of the Wrangler CLI using pnpm.	Exact payloads, commands, or snippets shown in A command to check the current installed version of the Wrangler CLI using pnpm.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-8.text`	A command to check the current Node.js version required for the Wrangler v4 migration.	Exact payloads, commands, or snippets shown in A command to check the current Node.js version required for the Wrangler v4 migration.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-9.text`	A shell command used to grep for wrangler kv and r2 references in configuration and script files to identify migration needs.	Exact payloads, commands, or snippets shown in A shell command used to grep for wrangler kv and r2 references in configuration and script files to identify migratio...
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-10.text`	A comparison of Wrangler v3 and v4 commands for retrieving a value from Cloudflare KV using the --remote flag.	Exact payloads, commands, or snippets shown in A comparison of Wrangler v3 and v4 commands for retrieving a value from Cloudflare KV using the --remote flag.
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-11.text`	Shell commands to identify deprecated configuration keys in wrangler.toml and wrangler.json files during a v3 to v4 migration.	Exact payloads, commands, or snippets shown in Shell commands to identify deprecated configuration keys in wrangler.toml and wrangler.json files during a v3 to v4 m...
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-12.text`	A grep command used to identify legacy wrangler flags like --legacy-assets and --node-compat within project configuration files.	Exact payloads, commands, or snippets shown in A grep command used to identify legacy wrangler flags like --legacy-assets and --node-compat within project configura...
`examples/workers-wrangler-migration-migrate-from-v3-to-v4-cloudflare-workers-wran-13.text`	A shell command used to search for getBindingsProxy occurrences in JavaScript, TypeScript, and MJS files to identify migration requirements.	Exact payloads, commands, or snippets shown in A shell command used to search for getBindingsProxy occurrences in JavaScript, TypeScript, and MJS files to identify...