---
title: "v6.0.0"
description: "Release notes for Nuxt SEO v6."
canonical_url: "https://nuxtseo.com/docs/nuxt-seo/releases/v6"
---

## Introduction

Nuxt SEO v6 moves every bundled module to a new major version. Two modules join the bundle: [AI Ready](/docs/ai-ready/getting-started/introduction) and [Skew Protection](/docs/skew-protection/getting-started/introduction).

The release drops Nuxt 3. Every module now requires Nuxt 4.6 or Nuxt 5, and Node 22.22.3+, 24.15.0+, or 26+. That floor lets the modules use Nuxt's portable server APIs, so each module carries less code of its own.

v6 installs two more modules and still weighs less. Against v5.3.16, it ships 44% less JavaScript to the browser, and its server build is 52% smaller. The Performance section below has the numbers.

If you only read one section, read Breaking Changes below. Most projects need three changes: upgrade Nuxt, install the DevTools host, and check OG Image signing.

## 🤖 AI Ready and Skew Protection, Bundled

`@nuxtjs/seo` now installs nine modules. AI Ready and Skew Protection install with the rest.

**AI Ready** makes your pages readable by AI agents. It generates `llms.txt` and `llms-full.txt`, and serves every page as Markdown at a `.md` URL. It publishes Agent Skills from `public/skills/<name>/SKILL.md`, and generates an API catalog when you configure an MCP server and a site URL.

**Skew Protection** keeps the assets of earlier builds available after a deploy. Open tabs and crawlers stop hitting `ChunkLoadError` and 404s on old chunks. Under Nuxt SEO it checks for new versions with Nuxt's hourly app manifest polling, so it opens no persistent connection. It also sets no version cookie.

Your options still go under the module keys. To turn either module off, set its key to `false`:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  modules: ['@nuxtjs/seo'],
  aiReady: false,
  skewProtection: false,
})
```

::warning
By default, Skew Protection stores old assets in `node_modules/.cache/nuxt-seo/skew-protection`. If your CI discards that directory between deploys, cache it. Otherwise each deploy loses the assets of earlier builds.
::

## ⚡ Performance

We built the same app with three versions:

- 5.3.12, the last release before the performance work started in August.
- 5.3.16, the last v5 release.
- v6.

Each app installs the same modules, including AI Ready and Skew Protection. Each app uses Nuxt i18n with two locales and renders OG images with Satori. "Over bare Nuxt" means the cost on top of the same app built without Nuxt SEO.

|                                                  | 5.3.12   | 5.3.16  | v6          |
| ------------------------------------------------ | -------- | ------- | ----------- |
| Nuxt SEO JavaScript in the browser, gzip         | 22.6 KB  | 26.8 KB | **14.9 KB** |
| Server build output, gzip                        | 12.5 MB  | 8.7 MB  | **4.2 MB**  |
| Install size, over bare Nuxt                     | 108 MB   | 125 MB  | **73 MB**   |
| Server memory after boot, over bare Nuxt         | 146 MB   | 148 MB  | **14 MB**   |
| Memory allocated per page render, over bare Nuxt | 1,031 KB | 954 KB  | **921 KB**  |

- **Browser JavaScript:** v6 ships 44% less than 5.3.16.
  - [Schema.org](http://Schema.org) no longer sends its code to the browser in the default mode.
  - Robots keeps bot detection out of the client bundle.
  - The new polling default for Skew Protection accounts for 4.2 KB of the 11.9 KB saved.
- **Server build:** v6 is 52% smaller than 5.3.16 (gzip). AI Ready used to bundle the mdream Markdown converter with a native binary for every platform, and the build copied all of them. Now your package manager installs only the binary for your platform ([nuxt-ai-ready#171](https://github.com/harlan-zw/nuxt-ai-ready/pull/171)). Earlier v5 patches already stopped copying `better-sqlite3` into the output.
- **Install size:** v6 installs 42% less than 5.3.16. These dependencies are now optional or gone:
  - `drizzle-orm`, needed only for AI Ready database features ([nuxt-ai-ready#172](https://github.com/harlan-zw/nuxt-ai-ready/pull/172)).
  - The mdream binaries for other platforms ([nuxt-ai-ready#171](https://github.com/harlan-zw/nuxt-ai-ready/pull/171)).
  - `zod` in Skew Protection ([nuxt-skew-protection#94](https://github.com/harlan-zw/nuxt-skew-protection/pull/94)).
  - `chrome-launcher` in OG Image, needed only for the browser renderer ([og-image#749](https://github.com/nuxt-modules/og-image/pull/749)).
  - `sharp`, which no longer installs by default.
- **Default install:** the test app also installs Satori, resvg, and `better-sqlite3`. Without them, Nuxt SEO adds 15 MB and 33 packages to a bare Nuxt app. If you render OG images, add the renderer you choose.
- **Boot memory:** v5 versions of AI Ready loaded their database code at startup, even with the database off. v6 loads it only when a feature needs the database. The full module set now adds 14 MB to a bare Nuxt app. A v5 app without AI Ready never paid this cost.
- **Page renders:** Nuxt SEO allocates about 11% less memory per render than in 5.3.12. Nuxt 4.6.1 and Unhead 3.4 cut the allocation of the bare app by about 30%.

<details>
<summary>
How we measured
</summary>
</details>

- Node 24.18.0 on an AMD Ryzen 9 9900X. We built each app with `nuxt build` and served it in production mode.
- 5.3.16 and v6 run on Nuxt 4.6.1. 5.3.12 runs on Nuxt 4.5.2, because its Unhead version cannot build on Nuxt 4.6.1. Each version is compared with a bare app on its own Nuxt version.
- For 5.3.12, every Nuxt SEO module and Unhead use the versions published before 11 August 2026.
- Sizes and allocations repeat within 0.5%. Takumi is not installed.
- We also timed server renders. The machine was under heavy load and the differences stayed inside the noise, so we do not report them.

## 🩺 Setup Checks in Development

Missing configuration used to stay silent until a crawler found the result. In v6, the first successful home page response in `nuxt dev` starts a background check across every installed module.

- **Required checks** report once per server start. Each one names the fix, the reason, and a docs link. A missing `site.url` is one of them.
- **Tips** suggest optional features that fit your app, such as a Sitemap or OG Image setting you have not enabled. After tips show, they stay quiet for seven days in that project. Required checks ignore this pause.

The same checks appear in the Nuxt SEO DevTools panel, with a refresh action. CI and AI agent sessions skip the terminal output. To hide tips but keep required checks, set `tips` to `false`:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  nuxtseo: { tips: false },
})
```

## 🧩 DevTools on Demand

The DevTools hosting code used to install for every user, including people who never open a panel. In v6 it lives in an optional package, `nuxtseo-devtools-host`. The shared core now installs 7 runtime dependencies, down from 14.

If you use the SEO panels in Nuxt DevTools, add the host as a development dependency:

```bash
npx nypm add -D nuxtseo-devtools-host
```

If the host is missing, each panel shows an install button. The first panel request builds the UI. A failed build stays visible in the panel and offers a retry.

## 🛡️ Version Checks That Fail the Build

Before v6, `@nuxtjs/seo` could run with the wrong module versions and report nothing.

- On a Nuxt version without module dependency support, no module installed. `/robots.txt` and `/sitemap.xml` returned 404 and the build passed.
- Nuxt checked the module copy nested inside `@nuxtjs/seo`, and loaded the copy your app resolved. A pinned older module passed the check.

Now a pinned older module stops the build and names the problem:

```text
ERROR  [@nuxtjs/seo] Module `@nuxtjs/sitemap` version (`8.6.1`) does not satisfy `>=9.0.0` (requested by `@nuxtjs/seo`).
```

An unsupported Nuxt version also stops the build. The error names your version, the required range, and the fix:

```text
ERROR  [@nuxtjs/seo] Nuxt 4.5.2 is not supported. @nuxtjs/seo requires Nuxt `^4.6.1 || ^5.0.0`. To upgrade Nuxt, run `npx nuxt upgrade`.
```

`nuxtseo: false` also works now. Before v6 it type checked but installed every module anyway. It now installs none of the bundled modules. A module that you add to `modules` yourself still installs.

## 🖼️ OG Image v7

OG Image v7 changes how images render, cache, and sign. Read the [OG Image v7 migration guide](/docs/og-image/migration-guide/v7) before you upgrade a project with custom templates.

- **Native Satori layout.** Satori 0.47 supports block, inline, and grid layout, plus `translate`, `rotate`, and `scale`. Templates now behave more like regular CSS. Bare `<div>`{lang="html"} elements no longer get a forced `display: flex`.
- **Publish to storage.** Serve generated images from a public R2 or S3 mount. Repeat requests skip the render, and builds reuse published images until their cache expires.
- **Fonts from `@nuxt/fonts` v1.** Prerendered images keep their fonts, and Takumi loads OTF and WOFF files.

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  ogImage: {
    publish: { storage: 'og-image-public', baseURL: 'https://images.example.com' },
  },
  nitro: {
    storage: {
      'og-image-public': { driver: 'cloudflare-r2-binding', binding: 'OG_IMAGES' },
    },
  },
})
```

## 🤖 Robots: Block Training Crawlers Only

Robots v7 adds `blockAiBots: 'training'`. It blocks crawlers that collect model training data, such as GPTBot, ClaudeBot, Google-Extended, and CCBot. AI search and answer agents can still read your site.

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  robots: { blockAiBots: 'training' },
})
```

Google-Extended also controls [Gemini](https://gemini.google.com) grounding. Blocking it removes your pages from that use too.

`definePageMeta({ robots })`{lang="ts"} now matches routes through your app's own router. It respects `sensitive`, `strict`, aliases, and i18n routes, so a private page no longer stays indexable because of a path mismatch.

## 🧭 More Module Improvements

- **Sitemap v9.** `definePageMeta({ sitemap: false })`{lang="ts"} also excludes prerendered dynamic pages, aliases, and case or trailing slash variants. Builds without streaming or compression drop that code.
- **[Schema.org](http://Schema.org) v7.** In the default non-reactive mode, `useSchemaOrg()`{lang="ts"} and the `define*()` helpers leave the client bundle again. The SSR JSON-LD output is unchanged.
- **SEO Utils v9.** Development and build warn when an indexable page renders only on the client, with a config example to copy. Derived meta tags take about half the CPU time per call.
- **Link Checker v6.** A build that scans no pages now says so in its log. Reports show the real HTTP status text, and a `HEAD` request that gets 405 or 501 retries with `GET`.
- **Site Config v5.** `getSiteConfig(event)`{lang="ts"} now works in your `server/middleware`. A prerender without `site.url` now warns, where it used to render relative URLs silently.
- **AI Ready v3.** Markdown negotiation reads the `Accept` header only, so caches need one `Vary` header. The AI Catalog at `/.well-known/ai-catalog.json` is also served at `/.well-known/ard.json`.
- **Skew Protection v2.** Open tabs share one connection through Web Locks. Core protection works without Robots or Site Config.

## 🧠 Agent Skill in the Package

`@nuxtjs/seo` now ships an Agent Skill at `skills/nuxtjs-seo/SKILL.md`. It tells a coding agent which module owns each config key, how to disable a module, and which install errors to expect. Get it on [skilld.dev](https://skilld.dev/gh/harlan-zw/nuxt-seo/nuxtjs-seo). Every bundled module now ships its own Agent Skill too.

## ⚠️ Breaking Changes

The list starts with the changes that affect the most projects.

### Nuxt 4.6.1 and Node 22.22.3 Minimum

Nuxt SEO v6 requires Nuxt `^4.6.1 || ^5.0.0`. Nuxt SEO v6 no longer supports Nuxt 3.

Node must match `^22.22.3 || ^24.15.0 || >=26.0.0`.

### AI Ready and Skew Protection Install by Default

Remove `nuxt-ai-ready` and `nuxt-skew-protection` from your `modules` array and your dependencies. `@nuxtjs/seo` installs them. Keep your options under `aiReady` and `skewProtection`, or set either key to `false`.

If you already configured Skew Protection, check these v2 changes:

- An unset `updateStrategy` now means hourly polling on every platform. For instant updates, set `updateStrategy: 'sse'` or `'ws'`.
- `experimental.appManifest: false` now fails setup.
- The default storage driver is `fs-lite`. An explicit `driver: 'fs'` still works.
- With `multiTab: true`, tabs share one push connection. To keep one connection per tab, set `multiTab: false` or `connectionTracking: true`.

If you already configured AI Ready, AI bots no longer get Markdown by User-Agent alone. Set `botNegotiation: true` to restore that. AI Ready drops the `better-sqlite3` fallback and uses `node:sqlite`.

### DevTools Panels Need `nuxtseo-devtools-host`

Install `nuxtseo-devtools-host` as a development dependency to keep the SEO panels. The DevTools on Demand section above shows the command.

### OG Image Signing Uses `NUXT_APP_SECRET`

If URL signing is on, set `NUXT_APP_SECRET` to a value of at least 32 characters. Without it, production image and page requests return a 500 error. If `security.secret` holds a string, remove it from your config. Generate a secret with `npx nuxt-og-image generate-secret`.

`NUXT_OG_IMAGE_SECRET` still works with a deprecation warning. Signed URLs from OG Image v6 become invalid, so purge cached HTML that contains them.

The [OG Image v7 migration guide](/docs/og-image/migration-guide/v7) also covers these changes:

- OG Image needs Satori 0.47. Add `flex flex-col` to elements that depended on the old forced flex layout.
- OG Image needs Takumi v2 (`^2.15.0`). Replace `takumi.fetchedResources` and `takumi.persistentImages` with `takumi.images`.
- Custom fonts need `@nuxt/fonts` v1. Families used only in OG images need `global: true`.

### Zod 4 for Nuxt Content Schemas

`defineRobotsSchema()`{lang="ts"}, `defineSitemapSchema()`{lang="ts"}, and `defineOgImageSchema()`{lang="ts"} require [Zod](https://zod.dev) 4. Upgrade the `zod` package in your app.

### Server Hooks Receive a `RequestEvent`

The `robots:*` and `sitemap:*` hook contexts now carry a `RequestEvent` from `nuxt/server`, in place of an h3 `H3Event`. Read request headers with the web API:

```ts [server/plugins/sitemap.ts]
export default defineNitroPlugin((nitroApp) => {
  nitroApp.hooks.hook('sitemap:sources', (ctx) => {
    // v5: ctx.event.node.req.headers.authorization
    const auth = ctx.event.req.headers.get('authorization')
  })
})
```

OG Image's `getOgImageUrl()`{lang="ts"} also takes a `RequestEvent`. Import `defineEventHandler` from `nuxt/server` in handlers that call it.

### Site Config Priority and Values

- `updateSiteConfig()`{lang="ts"} without `_priority` now ranks below your `site` key and `NUXT_SITE_*` variables. Pass `_priority: SiteConfigPriority.runtime` to keep the old order.
- `indexable` is now always a boolean. It defaults to `env === 'production'`.
- Module authors: Site Config v5 drops `installNuxtSiteConfig()`{lang="ts"}. Declare `nuxt-site-config` in `moduleDependencies`.

### Smaller Module Changes

- **Robots:** Robots v7 drops the `#internal/nuxt-robots` and `#internal/nuxt-simple-robots` aliases. Import from `#robots/server` or `#robots/app`. `robots.txt` files in `assets/` or `pages/` resolve from `srcDir` (`app/` in Nuxt 4).
- **Robots:** `noai` and `noimageai` route rules no longer mark a route as not indexable. A `robots:config` change made during a request now affects only that request.
- **Robots:** route rules now take precedence over `definePageMeta({ robots })`{lang="ts"}. If both set a rule for a page, the route rule wins.
- **Sitemap:** Sitemap v9 drops `nuxt-simple-robots` support. Use `@nuxtjs/robots` v7.
- **Link Checker:** Link Checker v6 drops Nuxt Content v2 support. Reports show the real status text, and an unreachable link reports status `0`.
- **SEO Utils:** `sharp` is an optional peer dependency. Add it to use `nuxt-seo-utils icons`. Runtime minification no longer rewrites inline JavaScript.
- **[Schema.org](http://Schema.org) and SEO Utils:** the bare `#schema-org` and `#seo-utils` aliases are replaced by `#schema-org/app`, `#schema-org/server`, and `#seo-utils/app`.
- **Nuxt Content:** Nuxt SEO v6 no longer supports Nuxt Content v2. Use Content v3.

## ✅ Upgrading

The [v5 to v6 migration guide](/docs/nuxt-seo/migration-guide/v5-to-v6) covers each change step by step. Upgrade Nuxt first, then Nuxt SEO:

```bash
npx nuxt upgrade
npx nypm add @nuxtjs/seo@^6
npx nypm add -D nuxtseo-devtools-host
```

If you pinned a bundled module in your `package.json`, update it to the version in the [table below](#module-versions) or remove it. An older pinned module now fails the build.

<details>
<summary>
🤖 LLM upgrade prompt: paste it into your coding agent to migrate a project
</summary>
</details>

```md
# Upgrade Guide: @nuxtjs/seo v5 to v6

Help me upgrade @nuxtjs/seo from v5 to v6 in this Nuxt project.
Scan the codebase for each pattern below, then show me a diff per change.

## Requirements
- Nuxt 4.6.1 or later (Nuxt 3 is not supported). Run `npx nuxt upgrade` first.
- Node ^22.22.3 || ^24.15.0 || >=26.0.0. Check `engines`, `.nvmrc`, and CI Node versions.

## 1. Bundled modules
@nuxtjs/seo v6 installs nuxt-ai-ready and nuxt-skew-protection.
- Search: `nuxt-ai-ready`, `nuxt-skew-protection` in nuxt.config.* modules and package.json.
- Remove them from `modules` and dependencies. Keep `aiReady` / `skewProtection` options.
- If the project should not use one, set `aiReady: false` or `skewProtection: false`.
- Skew Protection stores assets in node_modules/.cache/nuxt-seo/skew-protection. Cache it in CI.
- Skew Protection v2: unset `updateStrategy` now means polling; `experimental.appManifest: false` throws.
- AI Ready v3: bots no longer get Markdown by User-Agent. Set `aiReady: { botNegotiation: true }` to keep it.

## 2. Pinned module versions
Minimums: @nuxtjs/robots 7, @nuxtjs/sitemap 9, nuxt-og-image 7, nuxt-schema-org 7,
nuxt-seo-utils 9, nuxt-link-checker 6, nuxt-site-config 5, nuxt-ai-ready 3,
nuxt-skew-protection 2, @nuxtjs/i18n 10. Update or remove older pins in package.json.

## 3. DevTools
Add `nuxtseo-devtools-host` as a dev dependency if the project uses Nuxt DevTools.

## 4. OG Image v7
- Search: `security.secret`, `NUXT_OG_IMAGE_SECRET`, `ogImage.secret`.
  Remove `security.secret`; set `NUXT_APP_SECRET` (32+ chars) in the deploy environment.
- Search: `*.satori.vue` and components in `components/OgImage/`. Elements that relied on forced
  flex layout need `flex flex-col` classes.
- Search: `fetchedResources`, `persistentImages`. Replace with `takumi.images`.
- Search: `"@takumi-rs/core"`, `"satori"`, `"@nuxt/fonts"`. Need ^2.15.0, ^0.47.1, >=1.0.0.
- Full guide: https://nuxtseo.com/docs/og-image/migration-guide/v7

## 5. Zod 4
Search: `defineRobotsSchema`, `defineSitemapSchema`, `defineOgImageSchema`, `"zod"`.
Upgrade zod to ^4 and fix any [Zod](https://zod.dev) 3 API usage in content.config.ts.

## 6. Server hooks and events
Search: `sitemap:`, `robots:` hook handlers, `event.node.req`, `H3Event`, `getOgImageUrl(`.
- Hook contexts now carry a `RequestEvent` from `nuxt/server`.
  Before: `ctx.event.node.req.headers.authorization`
  After:  `ctx.event.req.headers.get('authorization')`
- Handlers that call `getOgImageUrl` import `defineEventHandler` from `nuxt/server`.

## 7. Site Config v5
- Search: `updateSiteConfig(`. Without `_priority` it now ranks below the `site` key and env vars.
  Add `_priority: SiteConfigPriority.runtime` where you need the old override behaviour.
- Search: `indexable === undefined`, `indexable == null`. `indexable` is always a boolean now.
- Search: `installNuxtSiteConfig`. Replace with a `moduleDependencies` entry for nuxt-site-config.

## 8. Smaller changes
- `#internal/nuxt-robots`, `#internal/nuxt-simple-robots` -> `#robots/server` or `#robots/app`.
- Bare `#schema-org` -> `#schema-org/app`; bare `#seo-utils` -> `#seo-utils/app`.
- `nuxt-simple-robots`, `nuxt-simple-sitemap`: remove; use @nuxtjs/robots and @nuxtjs/sitemap.
- `@nuxt/content` v2: Nuxt SEO v6 no longer supports it. Upgrade to Content v3.6 or later.
- `nuxt-seo-utils icons`: add `sharp` as a dev dependency.
- `assets/robots.txt` or `pages/robots.txt` at the root: move under `srcDir` (`app/`).

## Verify
1. Install dependencies and update the lockfile.
2. `npx nuxt typecheck`
3. `npx nuxt build`. A module version mismatch fails here with a named module.
4. `npx nuxt dev`, open the home page, and read the Nuxt SEO setup checks in the terminal.
5. Check /robots.txt, /sitemap.xml, /llms.txt, and one OG image URL.
```

## Module Versions

| Module                 | v5            | v6     |
| ---------------------- | ------------- | ------ |
| `nuxt-site-config`     | v4            | **v5** |
| `@nuxtjs/robots`       | v6            | **v7** |
| `@nuxtjs/sitemap`      | v8            | **v9** |
| `nuxt-og-image`        | v6            | **v7** |
| `nuxt-schema-org`      | v6            | **v7** |
| `nuxt-seo-utils`       | v8            | **v9** |
| `nuxt-link-checker`    | v5            | **v6** |
| `nuxt-ai-ready`        | *not bundled* | **v3** |
| `nuxt-skew-protection` | *not bundled* | **v2** |

## 👉 Changelog

> [Compare changes](https://github.com/harlan-zw/nuxt-seo/compare/v5.3.16...v6.0.0)

### 🚀 Enhancements

- Bundle AI Ready and Skew Protection by default ([#643](https://github.com/harlan-zw/nuxt-seo/pull/643))
- Require Nuxt 4.6 and isolate optional DevTools ([#645](https://github.com/harlan-zw/nuxt-seo/pull/645))
- Report development setup checks ([#644](https://github.com/harlan-zw/nuxt-seo/pull/644))
- Ship an Agent Skill in the package ([#631](https://github.com/harlan-zw/nuxt-seo/pull/631))
- Add brand marks and hand-drawn module icons ([#647](https://github.com/harlan-zw/nuxt-seo/pull/647))

### 🩹 Fixes

- Make `nuxtseo: false` skip the bundled modules ([#634](https://github.com/harlan-zw/nuxt-seo/pull/634))
- Fail on unsupported Nuxt and module versions ([#633](https://github.com/harlan-zw/nuxt-seo/pull/633))
- Point standalone modules at the harlan-zw org ([#628](https://github.com/harlan-zw/nuxt-seo/pull/628))

### 📦 Module Releases

Each module lists its full changes on [GitHub](https://github.com):
[Robots](https://github.com/nuxt-modules/robots/releases),
[Sitemap](https://github.com/nuxt-modules/sitemap/releases),
[OG Image](https://github.com/nuxt-modules/og-image/releases),
[Schema.org](https://github.com/harlan-zw/nuxt-schema-org/releases),
[SEO Utils](https://github.com/harlan-zw/nuxt-seo-utils/releases),
[Link Checker](https://github.com/harlan-zw/nuxt-link-checker/releases),
[Site Config](https://github.com/harlan-zw/nuxt-site-config/releases),
[AI Ready](https://github.com/harlan-zw/nuxt-ai-ready/releases),
[Skew Protection](https://github.com/harlan-zw/nuxt-skew-protection/releases).

### ❤️ Contributors

- [@harlan-zw](https://github.com/harlan-zw)
- [@danielroe](https://github.com/danielroe)
- [@0xgdr](https://github.com/0xgdr)
- [@yves-riot](https://github.com/yves-riot)
- [@Cypher-Aura-19](https://github.com/Cypher-Aura-19)
- [@rayblair06](https://github.com/rayblair06)
- [@nsturis](https://github.com/nsturis)
- [@lprnmns](https://github.com/lprnmns)
- [@pengzh1](https://github.com/pengzh1)
- [@Noumenon-ai](https://github.com/Noumenon-ai)

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.