v3 to v4

Last updated Jul 16, 2026Harlan Wilton

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.

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 OG Image v6 release notes.

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.