v3 to v4 · Nuxt SEO

-
-
-
-

[1.4K](https://github.com/harlan-zw/nuxt-seo)

[Nuxt SEO on GitHub](https://github.com/harlan-zw/nuxt-seo)

Nuxt SEO

-
-
-
-
-
-
-
-
-
-

Search…```k`` /`

v5.1.3

- Playgrounds
- [Discord Support](https://discord.com/invite/275MBUBvgP)

### Changelog

### Migration Guides

-
-
-
-
-

### Releases

-

Migration Guides

# v3 to v4

[Copy for LLMs](https://nuxtseo.com/docs/nuxt-seo/migration-guide/v3-to-v4.md)

## [Introduction](#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](#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](#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:

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

For the full list of breaking changes, new features, and manual migration steps, see the

.
## [Nuxt i18n v10](#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](#minimum-nuxt-version)

The minimum supported Nuxt version is now `3.16.0`.

[Edit this page](https://github.com/harlan-zw/nuxt-seo/edit/main/docs/content/6.migration-guide/4.v3-to-v4.md)

[Markdown For LLMs](https://nuxtseo.com/docs/nuxt-seo/migration-guide/v3-to-v4.md)

Did this page help you?

On this page

- [Introduction](#introduction)
- [Support](#support)
- [Nuxt OG Image v6](#nuxt-og-image-v6)
- [Nuxt i18n v10](#nuxt-i18n-v10)
- [Minimum Nuxt Version](#minimum-nuxt-version)

[GitHub](https://github.com/harlan-zw/nuxt-seo) [ Discord](https://discord.com/invite/275MBUBvgP)

###

-
-

Modules

-
-
-
-
-
-
-
-
-

###

-
-
-

###

Nuxt

-
-
-
-
-

Vue

-
-
-
-
-
-
-
-

###

-
-
-
-
-
-
-
-
-
-

Copyright © 2023-2026 Harlan Wilton - [MIT License](https://github.com/harlan-zw/nuxt-seo/blob/main/license) · [mdream](https://mdream.dev)