Canonical URL

Ensure a canonical URL is set to avoid duplicate content issues.

Introduction

It's common to have multiple URLs pointing to the same content. For example, supporting a www. and non-www. domain or misc-matched trailing slashes.

The "main" domain is called the canonical URL. Ensuring a single canonical URL helps avoid duplicate content issues and confusion for end-users.

Learn more about canonical URLs with the Canonical Link Tag guide.

Nuxt SEO automatically sets a canonical URL meta tag for you. This tag is generated from the site URL and the current route path.

<head>
    <!-- ... -->
    <link rel="canonical" href="https://example.com/my-page" />
</head>

The canonical URL is generated from:

site.url. Your Site Config url.
$route.path: The current route path.
canonicalQueryWhitelist: A list of query parameters that should be included in the canonical URL.

By default, the canonicalQueryWhitelist includes a number of common query parameters that will modify the page content:

You can override this by providing your own list of query parameters that should be included in the canonical URL.

nuxt.config.ts

export default defineNuxtConfig({
  seo: {
    canonicalQueryWhitelist: ['myCustomQuery']
  }
})

In some cases it may be preferred to redirect all non-canonical URLs to the canonical URL.

This redirect is optional and disabled by default.

nuxt.config.ts

export default defineNuxtConfig({
  seo: {
    redirectToCanonicalSiteUrl: true
  }
})

Did this page help you?

Troubleshooting

Create minimal reproductions for Nuxt SEO Utils or just experiment with the module.

App Icons

Learn how metadata files work with logos.