Migrate from Wrangler v2 to v3

Last updated Apr 23, 2026 There are no special instructions for migrating from Wrangler v2 to v3. You should be able to update Wrangler by following the instructions in Install/Update Wrangler. You should experience no disruption to your workflow.

Caution

If you tried to update to Wrangler v3 prior to v3.3, you may have experienced some compatibility issues with older operating systems. Please try again with the latest v3 where those have been resolved.

Deprecations

Refer to Deprecations for more details on what is no longer supported in v3.

Additional assistance

If you do have an issue or need further assistance, file an issue ↗︎ in the workers-sdk repo on GitHub.

Was this helpful?

YesNo

On this page

Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/migration/update-v2-to-v3/#page","headline":"Migrate from Wrangler v2 to v3","description":"Update Wrangler from v2 to v3 with no special migration steps required. Review deprecations and known issues.","url":"https://developers.cloudflare.com/workers/wrangler/migration/update-v2-to-v3/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/migration/update-v2-to-v3/og.png?v=aec7455ca9250075","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Upgrade Wrangler from v3 to v4, including breaking changes, updated Node.js requirements, and new defaults. title: Migrate from Wrangler v3 to v4 image: https://developers.cloudflare.com/workers/wrangler/migration/update-v3-to-v4/og.png?v=221f250adede3d31

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.