---
title: "v3 to v4 · Nuxt SEO"
canonical_url: "https://nuxtseo.com/docs/nuxt-seo/migration-guide/v3-to-v4"
last_updated: "2026-08-15T10:55:15.517Z"
meta:
  description: "Migrate from Nuxt SEO v3 to v4."
  "og:description": "Migrate from Nuxt SEO v3 to v4."
  "og:title": "v3 to v4 · Nuxt SEO"
---

Nuxt SEO on GitHub

Switch to Nuxt SEOSwitch to RobotsSwitch to SitemapSwitch to OG ImageSwitch to Schema.orgSwitch to Link CheckerSwitch to SEO UtilsSwitch to Site ConfigSwitch to Skew ProtectionSwitch to AI Ready

**Migration Guides**

# **v3 to v4**

## 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~~**](https://nuxtseo.com/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**`.

**Was this page helpful?**

### **Related **

[**v4 to v5**](https://nuxtseo.com/docs/nuxt-seo/migration-guide/v4-to-v5)

[**OG Image v6 Release Notes**](https://nuxtseo.com/docs/og-image/releases/v6)

[**Nuxt SEO Kit to Nuxt SEO** Migrate from the nuxt-seo-kit package v1 to the new v2 @nuxtjs/seo.](https://nuxtseo.com/docs/nuxt-seo/migration-guide/nuxt-seo-kit) [**v4 to v5** Migrate from Nuxt SEO v4 to v5.](https://nuxtseo.com/docs/nuxt-seo/migration-guide/v4-to-v5)