---
title: "v5.0.0"
description: "Release notes for Nuxt SEO v5."
canonical_url: "https://nuxtseo.com/docs/nuxt-seo/releases/v5"
last_updated: "2026-05-07T08:39:23.803Z"
---

## Introduction

Nuxt SEO v5 bumps every sub-module to a new major version (except OG Image, which stays on v6). The common thread is the **Site Config v4** dependency; addressing those changes first will make the rest of the migration smooth.

For step-by-step upgrade instructions, see the [v4 to v5 migration guide](/docs/nuxt-seo/migration-guide/v4-to-v5).

## 🛠️ DevTools Unity

The biggest change in v5 is that every Nuxt SEO module now shares a single DevTools foundation through our new **shared DevTools layer** (`nuxtseo-layer-devtools`).

Previously each module shipped its own DevTools client with inconsistent layouts, patterns, and capabilities. In v5, all DevTools clients extend a common Nuxt layer that provides:

- **Consistent layout and navigation** across every module, with a module switcher to jump between them
- **Setup checklist** that validates your configuration across all installed modules, flagging required and recommended actions
- **Built-in troubleshooting**, update indicators, and production mode preview in every module

Nuxt SEO Utils gets a brand new DevTools client for the first time, and the DevTools for Robots, Sitemap, Schema.org, and Link Checker have all been revamped to use the shared layer.

![Nuxt SEO v5 Setup Checklist showing module configuration tips for Site Config, Robots, and Sitemap](/images/nuxt-seo/releases/v5.png)

## 🔗 ESLint Link Checking

Nuxt Link Checker v5 ships an [ESLint](https://eslint.org) integration with zero-config `@nuxt/eslint` support:

- `link-checker/valid-route` (error): validates relative URLs match known routes with "did you mean?" suggestions
- `link-checker/valid-sitemap-link` (warn): checks URLs exist in the sitemap
- Scans Vue templates, TS/JS (`navigateTo`, `router.push`), and Markdown links

If you're using `@nuxt/eslint`, the rules are registered automatically. Otherwise, add them manually:

```ts [eslint.config.ts]
import linkChecker from 'nuxt-link-checker/eslint'

export default [
  linkChecker,
]
```

Example output when a link doesn't match any route:

```text
error  Link "/abut" does not match any known route. Did you mean "/about"?  link-checker/valid-route
```

## 📱 Social Share Links

SEO Utils v8 introduces `useShareLinks()`, a composable for generating social sharing URLs (Twitter, Facebook, LinkedIn, WhatsApp, Telegram, Reddit, Pinterest, Email) with built-in UTM tracking.

```vue
<script setup lang="ts">
const links = useShareLinks({
  title: 'Check out Nuxt SEO v5!',
  twitter: { via: 'harlodev', hashtags: ['nuxt', 'seo'] },
  utm: { source: 'auto', campaign: 'v5-launch' },
})
</script>

<template>
  <nav>
    <a :href="links.twitter">Share on X</a>
    <a :href="links.linkedin">Share on LinkedIn</a>
    <a :href="links.reddit">Share on Reddit</a>
  </nav>
</template>
```

The composable resolves the canonical URL of the current route automatically and appends per-platform UTM parameters. Pass `utm: false` to disable tracking entirely.

## 🖼️ Favicon Generation CLI

New `nuxt-seo-utils icons` CLI command generates all favicon and icon variants from a single source image:

```bash
npx nuxt-seo-utils icons --source logo.svg
```

This generates `favicon.ico`, `apple-touch-icon.png` (180x180), and PNG icons at 16, 32, 192, and 512px from your source image in `public/`. Requires `sharp` as a dev dependency.

## ⚡ Inline Minification

SEO Utils v8 automatically minifies inline scripts and styles injected via `useHead`.

**Before** (what you write):

```ts
useHead({
  script: [{
    innerHTML: `
      // Track page view
      window.dataLayer = window.dataLayer || [];
      window.dataLayer.push({
        'event': 'page_view',
        'page_path': window.location.pathname
      });
    `,
  }],
  style: [{
    innerHTML: `
      /* Critical above-the-fold styles */
      .hero {
        display: flex;
        align-items: center;
        justify-content: center;
        min-height: 100vh;
      }
    `,
  }],
})
```

**After** (rendered HTML):

```html
<script>window.dataLayer=window.dataLayer||[];window.dataLayer.push({event:"page_view",page_path:window.location.pathname});</script>
<style>.hero{display:flex;align-items:center;justify-content:center;min-height:100vh}</style>
```

## 📄 `definePageMeta` Sitemap Config

Sitemap v8 lets you configure sitemap options directly in `definePageMeta`:

```vue
<script setup lang="ts">
definePageMeta({
  sitemap: {
    changefreq: 'daily',
    priority: 0.8,
  },
})
</script>
```

## 🌐 i18n Multi-Sitemap Improvements

Custom sitemaps are now auto-expanded per locale when using i18n multi-sitemap mode. Previously you had to manually define a sitemap per locale. Now any sitemap with `includeAppSources: true` is automatically expanded:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  sitemap: {
    sitemaps: {
      // Expanded to "en-pages", "fr-pages", etc. automatically
      pages: { includeAppSources: true },
      // Static sitemaps without includeAppSources are kept as-is
      external: { urls: ['https://example.com/extra'] },
    },
  },
})
```

## ⚠️ Breaking Changes

All modules now depend on **Site Config v4**, which removes implicit site name inference, legacy `site*` runtime config keys, and several deprecated server-side APIs. Several Content v3 composables have also been renamed (e.g. `asSitemapCollection()` → `defineSitemapSchema()`).

See the [migration guide](/docs/nuxt-seo/migration-guide/v4-to-v5) for the full list of breaking changes and how to address them.

## 🐞 Bug Fixes

### SSR Memory Leaks Fixed

- **Schema.org**: reactive scopes not being disposed
- **Site Config**: computed refs in i18n plugin

### i18n Fixes

- Sitemap: base URL in multi-sitemap redirect, exclude filters with base URL/i18n prefixes, respect `autoI18n: false`
- SEO Utils: resolve fallback page titles from translation keys

### Other Fixes

- Schema.org: `@id` URLs now respect `app.baseURL`, Nuxt context preserved in computed refs
- Robots: `skipSiteIndexable` now skips `Disallow: /` rules, route rules nullish guard
- SEO Utils: error pages preserve user-defined titles, `useServerSeoMeta` takes precedence over site defaults
- Sitemap: chunked sitemaps path resolution, Content v3 `.navigation` path filtering
- Link Checker: serialize RegExp in `excludeLinks` for client-side filtering

## 📚 Live Examples

Every module now ships standalone examples in its repository. These are real Nuxt apps that stay in sync with the latest code, so they always reflect the current API.

Open any example directly in [StackBlitz](https://stackblitz.com):

<table>
<thead>
  <tr>
    <th>
      Module
    </th>
    
    <th>
      Examples
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Robots
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/nuxt-modules/robots/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/robots/tree/main/examples/i18n" rel="nofollow">
        i18n
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/robots/tree/main/examples/custom-rules" rel="nofollow">
        custom-rules
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Sitemap
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/nuxt-modules/sitemap/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/sitemap/tree/main/examples/i18n" rel="nofollow">
        i18n
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/sitemap/tree/main/examples/dynamic-urls" rel="nofollow">
        dynamic-urls
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        OG Image
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/basic-satori" rel="nofollow">
        basic-satori
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/basic-takumi" rel="nofollow">
        basic-takumi
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/content" rel="nofollow">
        content
      </a>
      
      , <a href="https://stackblitz.com/github/nuxt-modules/og-image/tree/main/examples/i18n" rel="nofollow">
        i18n
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Schema.org
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/harlan-zw/nuxt-schema-org/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-schema-org/tree/main/examples/blog" rel="nofollow">
        blog
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-schema-org/tree/main/examples/e-commerce" rel="nofollow">
        e-commerce
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Link Checker
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/harlan-zw/nuxt-link-checker/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-link-checker/tree/main/examples/broken-links" rel="nofollow">
        broken-links
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-link-checker/tree/main/examples/skip-inspection" rel="nofollow">
        skip-inspection
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        SEO Utils
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/harlan-zw/nuxt-seo-utils/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-seo-utils/tree/main/examples/breadcrumbs" rel="nofollow">
        breadcrumbs
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-seo-utils/tree/main/examples/meta-tags" rel="nofollow">
        meta-tags
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Site Config
      </strong>
    </td>
    
    <td>
      <a href="https://stackblitz.com/github/harlan-zw/nuxt-site-config/tree/main/examples/basic" rel="nofollow">
        basic
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-site-config/tree/main/examples/env-driven" rel="nofollow">
        env-driven
      </a>
      
      , <a href="https://stackblitz.com/github/harlan-zw/nuxt-site-config/tree/main/examples/multi-site" rel="nofollow">
        multi-site
      </a>
    </td>
  </tr>
</tbody>
</table>

Because examples live alongside each module's source, they are always tested against the latest version and never fall out of date.

## Module Version Summary

<table>
<thead>
  <tr>
    <th>
      Module
    </th>
    
    <th>
      v4
    </th>
    
    <th>
      v5
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        nuxt-site-config
      </code>
    </td>
    
    <td>
      v3
    </td>
    
    <td>
      <strong>
        v4
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        nuxt-seo-utils
      </code>
    </td>
    
    <td>
      v7
    </td>
    
    <td>
      <strong>
        v8
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        @nuxtjs/sitemap
      </code>
    </td>
    
    <td>
      v7
    </td>
    
    <td>
      <strong>
        v8
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        @nuxtjs/robots
      </code>
    </td>
    
    <td>
      v5
    </td>
    
    <td>
      <strong>
        v6
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        nuxt-schema-org
      </code>
    </td>
    
    <td>
      v5
    </td>
    
    <td>
      <strong>
        v6
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        nuxt-link-checker
      </code>
    </td>
    
    <td>
      v4
    </td>
    
    <td>
      <strong>
        v5
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        nuxt-og-image
      </code>
    </td>
    
    <td>
      v6
    </td>
    
    <td>
      v6 <em>
        (no major change)
      </em>
    </td>
  </tr>
</tbody>
</table>