The official Nuxt Certification Program in partnership with VueSchool is coming.

Upgrade Guide

Learn how to upgrade to the latest Nuxt version.

Upgrading Nuxt 3

Latest release

To upgrade Nuxt 3 to the latest release, use the nuxi upgrade command.

npx nuxi upgrade

Nightly Release Channel

To use the latest Nuxt 3 build and test features before their release, read about the nightly release channel guide.

Nuxt 2 vs Nuxt 3

In the table below, there is a quick comparison between 3 versions of Nuxt:

Feature / VersionNuxt 2Nuxt BridgeNuxt 3
Stability๐Ÿ˜Š Stable๐Ÿ˜Œ Semi-stable๐Ÿ˜Š Stable
Performance๐ŸŽ Fastโœˆ๏ธ Faster๐Ÿš€ Fastest
Nitro EngineโŒโœ…โœ…
ESM support๐ŸŒ™ Partial๐Ÿ‘ Betterโœ…
TypeScriptโ˜‘๏ธ Opt-in๐Ÿšง Partialโœ…
Composition APIโŒ๐Ÿšง Partialโœ…
Options APIโœ…โœ…โœ…
Components Auto Importโœ…โœ…โœ…
<script setup> syntaxโŒ๐Ÿšง Partialโœ…
Auto ImportsโŒโœ…โœ…
Viteโš ๏ธ Partial๐Ÿšง Partialโœ…
Nuxi CLIโŒ Oldโœ… nuxiโœ… nuxi
Static sitesโœ…โœ…โœ…

Nuxt 2 to Nuxt 3

The migration guide provides a step-by-step comparison of Nuxt 2 features to Nuxt 3 features and guidance to adapt your current application.

Check out the guide to migrating from Nuxt 2 to Nuxt 3.

Nuxt 2 to Nuxt Bridge

If you prefer to progressively migrate your Nuxt 2 application to Nuxt 3, you can use Nuxt Bridge. Nuxt Bridge is a compatibility layer that allows you to use Nuxt 3 features in Nuxt 2 with an opt-in mechanism.

Migrate from Nuxt 2 to Nuxt Bridge