Canonical URL · 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) ### Getting Started - [Introduction](https://nuxtseo.com/docs/seo-utils/getting-started/introduction) - [Installation](https://nuxtseo.com/docs/seo-utils/getting-started/installation) - [Troubleshooting](https://nuxtseo.com/docs/seo-utils/getting-started/troubleshooting) ### Core Concepts - [Canonical URL](https://nuxtseo.com/docs/seo-utils/guides/canonical-url) - [App Icons](https://nuxtseo.com/docs/seo-utils/guides/app-icons) - [Open Graph Images](https://nuxtseo.com/docs/seo-utils/guides/open-graph-images) - [Best Practice Default Meta](https://nuxtseo.com/docs/seo-utils/guides/default-meta) - [Enhanced Titles](https://nuxtseo.com/docs/seo-utils/guides/fallback-title) - [SEO Route Rules](https://nuxtseo.com/docs/seo-utils/guides/route-rules) - [I18n & Localization](https://nuxtseo.com/docs/seo-utils/guides/i18n) - [Nuxt Config SEO Meta](https://nuxtseo.com/docs/seo-utils/guides/nuxt-config-seo-meta) - [CLI](https://nuxtseo.com/docs/seo-utils/guides/cli) - [Inline Minification](https://nuxtseo.com/docs/seo-utils/guides/minification) Core Concepts # Canonical URL [Copy for LLMs](https://nuxtseo.com/docs/seo-utils/guides/canonical-url.md) ## [Introduction](#introduction) A canonical URL tells search engines which version of a page is the "main" one. Nuxt SEO automatically sets this for you using your site URL and current route path. Multiple URLs often point to the same content (www vs non-www, trailing slashes). The canonical URL prevents [duplicate content issues](https://support.google.com/webmasters/answer/66359?hl=en) and confusion for end-users. Learn more about canonical URLs with the [Canonical Link Tag](https://nuxtseo.com/learn-seo/nuxt/controlling-crawlers/canonical-urls) guide. ## [Canonical Head Tag](#canonical-head-tag) Nuxt SEO automatically sets a canonical URL meta tag for you. This tag is generated from the site URL and the current route path. ``` ``` ### [Disabling Canonical URLs](#disabling-canonical-urls) If you need to disable automatic canonical URL generation completely, you can do so by setting the canonical URL to `false` in your SEO meta configuration: nuxt.config.ts ``` export default defineNuxtConfig({ seo: { meta: { canonical: false } } }) ``` You can also disable it on a per-page basis using `useSeoMeta`: ``` useSeoMeta({ canonical: false }) ``` ### [canonicalLowercase](#canonicallowercase) By default, the canonical URL is generated in lowercase. This is to ensure that the canonical URL is consistent and avoids any issues with case sensitivity. While it's recommended to keep this on, if you need to disable this feature, you can do so by setting `canonicalLowercase` to `false`. nuxt.config.ts ``` export default defineNuxtConfig({ seo: { canonicalLowercase: false } }) ``` ### [canonicalQueryWhitelist](#canonicalquerywhitelist) The canonical URL is generated from: - `site.url`. Your [Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction) 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: - `page` - `sort` - `filter` - `search` - `q` - `category` - `tag` 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'] } }) ``` ## [Redirect To Canonical](#redirect-to-canonical) 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 } }) ``` [Edit this page](https://github.com/harlan-zw/nuxt-seo-utils/edit/main/docs/content/2.guides/0.canonical-url.md) [Markdown For LLMs](https://nuxtseo.com/docs/seo-utils/guides/canonical-url.md) Did this page help you? [Troubleshooting Create minimal reproductions for Nuxt SEO Utils or just experiment with the module.](https://nuxtseo.com/docs/seo-utils/getting-started/troubleshooting) [App Icons Learn how metadata files work with logos.](https://nuxtseo.com/docs/seo-utils/guides/app-icons) On this page - [Introduction](#introduction) - [Canonical Head Tag](#canonical-head-tag) - [Redirect To Canonical](#redirect-to-canonical) [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)