Docs SEO
Canonical URL
Checks that your homepage has a canonical link tag pointing at the exact address it loads at, so search engines index the right version.
What it checks
We read <link rel="canonical"> on the homepage and resolve it against the address the homepage finally loaded at. It must match on protocol, host and path. A trailing slash and the query string are ignored.
- PassThe canonical points at the address the homepage loads at.
- WarningNo canonical tag, or it points at another address, such as www instead of no www, http instead of https, or another page. This check never fails.
Why it matters
The same page can often be reached at several addresses: with and without www, with tracking parameters, over http. The canonical tag tells search engines which one is the main copy.
A canonical that points somewhere else asks search engines to index that other address instead, or makes them ignore the tag.
How to fix it
Use a full https:// address that matches exactly where the homepage loads, including www or not. Most platforms add the tag on their own; when the check warns, it is usually because the site's main address setting does not match the domain visitors end up on.
Platform notes
SEO plugins add a self-referencing canonical. If it shows the wrong host, check the WordPress Address and Site Address under Settings, General.
Themes print the canonical with Shopify's canonical_url value. Make sure the domain you want is set as primary.
Check the global canonical tag URL in the site's SEO settings, and set your main domain as the default in hosting.
Canonical tags are added for you. Make sure the domain you want is set as the primary domain.
Set alternates.canonical in the metadata, with metadataBase set to your production domain.
Your report shows what this check found on your site. Pro shows the exact fix for your site. See pricing.
Questions
Does a canonical tag force search engines to use my address?
No, it is a strong hint. Search engines also look at redirects, internal links and sitemaps, so keep all of them pointing at the same address.
Free, about 30 seconds, with every other check included.