agentspeed.
← all fixes
Remediation

A canonical URL is declared and resolves to the same page.

markup.canonicaldiscoverabilityweight 2deterministicauto-fix available
Why it matters

Without <link rel="canonical">, agents cannot tell which version of a URL is the source of truth. Tracking parameters, A/B variants, and pagination produce duplicate content; agents cite whichever URL they happened to crawl, which fragments your authority across copies.

Underlying specification: https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls

How to fix
  1. Add `<link rel="canonical" href="https://your-domain/canonical-url">` in the <head> of every page.
  2. Self-reference: a page at /docs/quickstart canonicalises to /docs/quickstart, not /docs.
  3. Strip tracking parameters (utm_*, gclid, etc.) from the canonical URL.
  4. For paginated lists, point page 2+ at page 1 only when the content overlaps; otherwise self-canonicalise each page.
Generated snippet

The snippet below uses your-domain.example as a placeholder. Replace it with your actual host before deploying. For a fix tailored to your live site, run a scan and open the per-domain remediation page.

Generated fixinline snippet<head>

AgentSpeed couldn't find a canonical link on the page. Agents use canonical to dedupe quoted citations. Without it, the same content cited twice from /page and /page?utm=foo looks like two distinct sources.

<!-- Place inside <head>. Replace /<path> with the canonical URL of THIS page. -->
<link rel="canonical" href="https://your-domain.example/<path>" />
paste inside <head>
  • Use the absolute URL form (`https://...`), not relative.
  • The href should be the canonical page URL, not the request URL, so strip query params, tracking codes, and trailing slashes consistently.
Hand it to your AI assistant

Paste this into Claude Code, Cursor, or any assistant with your repository open. It carries the steps, how to verify them, and the shortcuts to avoid. It is generic, though: run a scan to get one written from what your pages actually do.

Run a scan to check your site
Verify on your site

Run a scan against your domain to see whether markup.canonical currently passes, warns, or fails. Free, no signup; the score page is permanent and citable.

Run a scan →See the full rubric →
Fix markup.canonical · AgentSpeed