v7.0.0 · Nuxt SEO Utils · Nuxt SEO

[NuxtSEO](https://nuxtseo.com/ "Home")

- [Modules](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [Tools](https://nuxtseo.com/tools)
- [Pro](https://nuxtseo.com/pro)
- [Learn SEO](https://nuxtseo.com/learn-seo/nuxt) [Releases](https://nuxtseo.com/releases)

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

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

[User Guides](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)

[API](https://nuxtseo.com/docs/seo-utils/api/breadcrumbs)

[Releases](https://nuxtseo.com/docs/seo-utils/releases/v8)

SEO Utils

- [Switch to SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
- [Switch to Nuxt SEO](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [Switch to Robots](https://nuxtseo.com/docs/robots/getting-started/introduction)
- [Switch to Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction)
- [Switch to OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction)
- [Switch to Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction)
- [Switch to Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
- [Switch to Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction)
- [Switch to Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction)
- [Switch to AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction)

Search…```k`` /`

v8.1.7

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

### Changelog

### Releases

- [v8.0.0](https://nuxtseo.com/docs/seo-utils/releases/v8)
- [v7.0.0](https://nuxtseo.com/docs/seo-utils/releases/v7)
- [v6.0.0](https://nuxtseo.com/docs/seo-utils/releases/v6)
- [v5.0.0](https://nuxtseo.com/docs/seo-utils/releases/v5)
- [v4.0.0](https://nuxtseo.com/docs/seo-utils/releases/v4)
- [v3.0.0](https://nuxtseo.com/docs/seo-utils/releases/v3)

Releases

# v7.0.0

[Copy for LLMs](https://nuxtseo.com/docs/seo-utils/releases/v7.md)

## [Introduction](#introduction)

The v7 major includes improved defaults for safer canonical URLs, improved breadcrumb usage and support for automatic icon creation.

## [Nuxt Version Requirement](#nuxt-version-requirement)

Nuxt SEO Utils v7 requires Nuxt v3.16 or later.

Please upgrade your Nuxt version using `nuxi upgrade --force`.

## [Lowercase Canonical URLs [#41](https://github.com/harlan-zw/nuxt-seo-utils/pull/41)](#lowercase-canonical-urls-41)

Lowercases the canonical URLs to avoid duplicate content issues when displaying URLs that may have different capitalization.

### [Breaking Changes](#breaking-changes)

If you have URLs that are intentionally cased then this may lead to some issues, it's recommended to disable canonicalLowercase.

```
export default defineNuxtConfig({
  seo: {
    canonicalLowercase: false
  }
})
```

## [Shared Breadcrumb Context](#shared-breadcrumb-context)

If you were previously generating multiple breadcrumb lists on the same page without specifying an `id`, you will now run into issues with context being shared between the components.

This is intentional as previously you would be rendering invalid Schema.org markup.

To fix this you should specify an `id` which will have shared context.

```
useBreadcrumbItems({
  id: 'my-breadcrumb',
})
```

### [Breaking Changes](#breaking-changes-1)

If you have multiple breadcrumbs on your page please verify this new logic doesn't cause them to conflict.

If they do make sure you are setting a unique `id` for each one.

[Edit this page](https://github.com/harlan-zw/nuxt-seo-utils/edit/main/docs/content/4.releases/2.v7.md)

[Markdown For LLMs](https://nuxtseo.com/docs/seo-utils/releases/v7.md)

Did this page help you?

[v8.0.0 Release notes for v8.0.0 of Nuxt SEO Utils.](https://nuxtseo.com/docs/seo-utils/releases/v8) [v6.0.0 Release notes for v6.0.0 of Nuxt SEO Utils.](https://nuxtseo.com/docs/seo-utils/releases/v6)

On this page

- [Introduction](#introduction)
- [Nuxt Version Requirement](#nuxt-version-requirement)
- [Lowercase Canonical URLs #41](#lowercase-canonical-urls-41)
- [Shared Breadcrumb Context](#shared-breadcrumb-context)

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

### [NuxtSEO](https://nuxtseo.com/ "Home")

- [Getting Started](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [MCP](https://nuxtseo.com/docs/nuxt-seo/guides/mcp)

Modules

- [Robots](https://nuxtseo.com/docs/robots/getting-started/introduction)
- [Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction)
- [OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction)
- [Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction)
- [Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
- [SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
- [Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction)
- [Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction)
- [AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction)

### [NuxtSEO Pro](https://nuxtseo.com/pro "Home")

- [Getting Started](https://nuxtseo.com/pro)
- [Dashboard](https://nuxtseo.com/pro/dashboard)
- [Pro MCP](https://nuxtseo.com/docs/nuxt-seo-pro/mcp/installation)

### [Learn SEO](https://nuxtseo.com/learn-seo "Learn SEO")

Nuxt

- [Mastering Meta](https://nuxtseo.com/learn-seo/nuxt/mastering-meta)
- [Controlling Crawlers](https://nuxtseo.com/learn-seo/nuxt/controlling-crawlers)
- [Launch & Listen](https://nuxtseo.com/learn-seo/nuxt/launch-and-listen)
- [Routes & Rendering](https://nuxtseo.com/learn-seo/nuxt/routes-and-rendering)
- [Staying Secure](https://nuxtseo.com/learn-seo/nuxt/routes-and-rendering/security)

Vue

- [Vue SEO Guide](https://nuxtseo.com/learn-seo/vue)
- [Mastering Meta](https://nuxtseo.com/learn-seo/vue/mastering-meta)
- [Controlling Crawlers](https://nuxtseo.com/learn-seo/vue/controlling-crawlers)
- [SPA SEO](https://nuxtseo.com/learn-seo/vue/spa)
- [SSR Frameworks](https://nuxtseo.com/learn-seo/vue/ssr-frameworks)
- [SEO Checklist](https://nuxtseo.com/learn-seo/checklist)
- [Pre-Launch Warmup](https://nuxtseo.com/learn-seo/pre-launch-warmup)
- [Backlinks & Authority](https://nuxtseo.com/learn-seo/backlinks)

### [Tools](https://nuxtseo.com/tools "SEO Tools")

- [Social Share Debugger](https://nuxtseo.com/tools/social-share-debugger)
- [Robots.txt Generator](https://nuxtseo.com/tools/robots-txt-generator)
- [Meta Tag Checker](https://nuxtseo.com/tools/meta-tag-checker)
- [HTML to Markdown](https://nuxtseo.com/tools/html-to-markdown)
- [XML Sitemap Validator](https://nuxtseo.com/tools/xml-sitemap-validator)
- [Schema.org Validator](https://nuxtseo.com/tools/schema-validator)
- [Keyword Idea Generator](https://nuxtseo.com/tools/keyword-generator)
- [Keyword Research](https://nuxtseo.com/tools/keyword-research)
- [SERP Analyzer](https://nuxtseo.com/tools/serp-analyzer)
- [Domain Rankings](https://nuxtseo.com/tools/domain-rankings)

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