Self-referencing canonical on every page (not just duplicate pages)

Issue No: 174

Category: page seo basics

Issue type: Warning

Priority: IMPORTANT

Description

Verify that each indexable page includes a canonical URL that self-references its own preferred URL so canonical intent is explicit even when duplicates are not obvious.

How do we capture it

1. Fetch page URL and record final URL after redirect resolution.
2. Parse raw HTML head and extract canonical href value.
3. Normalize final URL and canonical URL for strict comparison:
   • Normalize host case.
   • Remove default ports.
   • Normalize trailing slash according to site policy.
   • Preserve query only when part of canonical policy.
4. Determine self-reference status by exact comparison between normalized final URL and normalized canonical URL.
5. Mark page as non-compliant when canonical is missing or points to another URL without explicit duplication context.
6. Store mismatch reason (missing canonical, cross-page canonical, normalization mismatch).
7. Constraint: evaluation uses HTTP response and raw HTML only.

What to store

Field	Type	Comment
page_url TEXT	TEXT	Requested page URL.
final_url TEXT	TEXT	Final URL after redirects.
canonical_url TEXT	TEXT	Extracted canonical URL normalized to absolute.
has_canonical_tag BOOLEAN	BOOLEAN	Whether canonical tag exists.
normalized_final_url TEXT	TEXT	Final URL normalized for canonical comparison.
normalized_canonical_url TEXT	TEXT	Canonical URL normalized for canonical comparison.
canonical_is_self_referencing BOOLEAN	BOOLEAN	Whether canonical points to same normalized URL.
canonical_self_reference_reason TEXT	TEXT	Reason when self-reference check fails.
canonical_comparison_diagnostics JSONB	JSONB	Detailed comparison evidence and normalization outputs.

Condition for trigger

This audit triggers when page canonical is missing or not self-referencing.

• Trigger Rule 1: Missing Canonical Tag

  • Target Field: has_canonical_tag
  • Evaluation Logic: has_canonical_tag = FALSE
  • Severity: WARNING
  • Diagnostic Message: "Page does not declare a canonical URL."

• Trigger Rule 2: Canonical Not Self-Referencing

  • Target Field: canonical_is_self_referencing
  • Evaluation Logic: has_canonical_tag = TRUE AND canonical_is_self_referencing = FALSE
  • Severity: WARNING
  • Diagnostic Message: "Canonical URL does not self-reference this page."

• Trigger Rule 3: Canonical Comparison Failed Due to Normalization Conflict

  • Target Field: canonical_self_reference_reason
  • Evaluation Logic: canonical_self_reference_reason IS NOT NULL AND canonical_self_reference_reason <> ''
  • Severity: WARNING
  • Diagnostic Message: "Canonical self-reference validation found a URL normalization mismatch."

Sources

• Google Canonicalization Guidance: https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls
• WHATWG URL Standard: https://url.spec.whatwg.org/
• RFC 3986 URI Generic Syntax: https://www.rfc-editor.org/rfc/rfc3986

Long description

Self-referencing canonicals provide explicit preferred-URL declarations for each page. Even when no obvious duplicate exists, this practice reduces ambiguity from tracking parameters, alternate paths, and protocol/host variants. Without self-reference consistency, search engines may choose a different canonical than intended based on discovered duplicates or linking patterns.

Common failure scenarios checked by the crawler:

• Canonical missing on indexable pages.
• Canonical points to a different page for non-duplicate content.
• Canonical differs due to path, slash, protocol, or host normalization mismatch.
• Template-level canonical logic uses global fallback instead of page-specific target.

How to Fix

Publish one canonical tag on every indexable page and point it to that page's preferred final URL. Apply consistent URL normalization rules in canonical generation and ensure internal links and sitemaps align with the same preferred URL form.