Definition v1.0, updated 2026-07-07

What a canonical URL is

The one address you want engines to treat as the real version of a page.

A canonical URL is the address you want an engine to treat as the true version of a page, when the same content is reachable at more than one URL. You declare it with a link tag in the head, rel canonical, pointing at the chosen address.

Duplication is more common than it looks. A page can be reached with and without a trailing slash, with tracking parameters, at http and https, or served as html and as json. Left alone, engines see several pages, split the signals between them, and may pick the wrong one.

A canonical is a hint, not an order. Engines usually respect it but can ignore it, so back it up: point your internal links at the canonical URL, keep it consistent, and do not canonical a page to one that is genuinely different.

For content you cannot add a link tag to, such as a json or markdown file, set the canonical in the HTTP response header instead, with Link: <url>; rel="canonical". Topkay checks the canonical on a page, tells you where it points, and generates the header form in Fix-it. See also crawl budget.

Read next

What is ARMX

Agent Readiness and Machine eXperience: the five things every machine does with your site, and the one score that measures them.

What is answerability

How easily an AI answer engine can find and lift the answer from your page.

SEO, AEO and GEO, the difference

Ranking pages, being the answer, being cited by models. Three jobs, not three names.

All topics
Ask Topkay the analyst×
Ask me anything about your site. I read your twin and the Learn corpus, and cite both. Try a skill below.