---
title: "v3 to v4"
description: "Migrate from Nuxt SEO v3 to v4."
canonical_url: "https://nuxtseo.com/docs/nuxt-seo/migration-guide/v3-to-v4"
last_updated: "2026-05-06T21:38:30.119Z"
---

## Introduction

Nuxt SEO v4 is a major release that bumps the minimum version of `nuxt-og-image` to v6 and requires `@nuxtjs/i18n` v10+ (if used).

All other sub-modules remain on their current major versions with no breaking changes.

## Support

If you get stuck with the migration or have post-migration bugs, please get in touch.

- [Jump in the Discord](https://discord.com/invite/5jDAMswWwX)
- [Make a GitHub issue](https://github.com/harlan-zw/nuxt-seo/issues)

## Nuxt OG Image v6

OG Image v6 is the biggest change in this release. It introduces a new Rust-based renderer (Takumi), unbundles renderer dependencies, and changes how it detects OG Image components.

Run the automated migration CLI to handle most changes:

```bash
npx nuxt-og-image migrate v6
```

For the full list of breaking changes, new features, and manual migration steps, see the [OG Image v6 release notes](/docs/og-image/releases/v6).

## Nuxt i18n v10

If you use `@nuxtjs/i18n`, Nuxt SEO v4 now requires v10+. This is declared as an optional peer dependency; if you don't use i18n, no action is necessary.

## Minimum Nuxt Version

The minimum supported Nuxt version is now `3.16.0`.