---
title: Migrate Your Nuxt App to Unhead v2
description: 'Upgrade from Unhead v1 to v2 in Nuxt 3.16+. Migration guide for Nuxt v4 mode compatibility and breaking changes.'
navigation:
  title: Upgrade Guide
---

## Introduction

As of Nuxt 3.16, Unhead v2 is the default version for Nuxt.

While this change was made without breaking changes, if you've opted into the Nuxt v4 mode, you may have run into some issues.

### Nuxt v4 Migration

The best resource for managing the migration is the official [Nuxt v4 migration guide](https://nuxt.com/docs/getting-started/upgrade#migrating-to-nuxt-4).

For the full list of changes or if you still
have issues check out the [Unhead v2 migration guide](/docs/vue/migration).