Nuxt 4 introduces several new features and improvements, including performance and API consistency improvements. Codemod supports a mostly automated Nuxt 4 upgrade experience. This page provides tips and resources you may need for a successful migration.

​
Getting started

Nuxt 4 Upgrade Guide

Nuxt 4 Upgrade Recipe

​
Migration Steps

1

Opt in to Nuxt 4

  1. Upgrade to the latest version of Nuxt: 
    npx nuxi upgrade
  2. Set compatibilityVersion to match Nuxt 4 behavior:
    nuxt.config.ts
    export default defineNuxtConfig({
future: {
    compatibilityVersion: 4,
},
})
For more info, please refer to opting in to Nuxt 4.
2

Run migration codemods

npx codemod nuxt/4/migration-recipe
The recipe includes the following codemods:For a list of all available codemods, see Codemod Registry.