●Change8

Migrating to Nuxt v3.16.0

Version v3.16.0 introduces 1 breaking change. This guide details how to update your code.

Released: 3/7/2025

1
Breaking Changes
4
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

useHeadinjectHeaduseAsyncDataloadNuxtdefineNuxtConfig

Breaking Changes

●Issue #1

Upgraded to Unhead v2. While a compatibility build is provided for Nuxt 3, direct imports from '@unhead/vue' may lose async context. Users should switch to Nuxt auto-imports or '#app/composables/head'.

Migration Steps

  1. 1
    Update Nuxt to v3.16.
  2. 2
    If using Unhead directly, update imports from '@unhead/vue' to Nuxt auto-imports or '#app/composables/head'.
  3. 3
    If using compatibilityVersion: 4, review the specific Unhead v2 upgrade guide.
  4. 4
    Optional: Replace 'nuxi init' with 'npm create nuxt' for new projects.

Release Summary

Nuxt v3.16 introduces native lazy hydration, an upgraded Devtools v2, and significant performance improvements through new module resolution logic. It also transitions to Unhead v2 for head management and introduces a streamlined 'create-nuxt' CLI tool.

Need More Details?

View the full release notes and all changes for Nuxt v3.16.0.

View Full Changelog