SEO Guide · 2026

Shopify Canonical URLs for AI Shopping Agents

Every Shopify product is reachable via at least two URL paths: /products/[handle] and /collections/[handle]/products/[handle]. Without canonical discipline, AI shopping agents index both URLs — splitting authority and confusing product deduplication across the Shopping Graph.

The canonical URL problem in Shopify

Shopify's architecture means products exist at multiple URL paths simultaneously. Without a canonical declaration, each path would compete against the others in AI agent indexes:

Why the variant canonical matters for AI agents

When all variants share a single canonical URL (/products/[handle]), AI shopping agents that want to deep-link a user to a specific color or size cannot do so reliably. A shopper asking ChatGPT Shopping for "blue merino base layer size M" will get a link to the generic product page, not the pre-selected variant URL.

This is a known limitation of Shopify's canonical implementation — and it's intentional from Shopify's perspective (variant URLs with query parameters should not be independently indexed). The practical impact for AI agent recommendations:

• AI agents match your product to the query, but the click-through lands on the base product page rather than the variant.
• Shoppers must then select their variant manually, adding friction to the AI-referred purchase flow.
• For products with very different prices per variant (e.g., bundled sizes), the AI agent may display a price that doesn't match what the shopper sees after variant selection.

Mitigation: variant-level structured data in JSON-LD

While you can't canonical each variant separately without creating serious duplicate-content problems, you can help AI agents understand variant data by using the ProductGroup + hasVariant pattern in your Product JSON-LD:

// ProductGroup with variant offers — helps AI agents understand
// all available sizes/colors without needing separate indexed pages
{
  "@type": "ProductGroup",
  "name": "Merino Base Layer",
  "url": "https://yourstore.com/products/merino-base-layer",
  "hasVariant": [
    {
      "@type": "Product",
      "name": "Merino Base Layer — Blue / M",
      "sku": "MBL-BLUE-M",
      "gtin13": "1234567890123",
      "offers": {
        "@type": "Offer",
        "price": "89.95",
        "availability": "https://schema.org/InStock",
        "url": "https://yourstore.com/products/merino-base-layer?variant=44123456"
      }
    }
  ]
}

The variant URLs in offers.url are not indexed as separate canonical pages but do give AI agents a direct deep-link for each purchasable SKU. This is how leading DTC stores handle variant discoverability without breaking canonical discipline.

Diagnosing canonical issues in your Shopify store

Run these checks to confirm your canonical configuration is correct:

# 1. Verify collection-product canonical resolves correctly:
curl -s "https://yourstore.com/collections/[col]/products/[product]" \
  | grep 'rel="canonical"'
# Should output: <link rel="canonical" href="https://yourstore.com/products/[product]">

# 2. Verify variant canonical strips the parameter:
curl -s "https://yourstore.com/products/[product]?variant=12345" \
  | grep 'rel="canonical"'
# Should output: <link rel="canonical" href="https://yourstore.com/products/[product]">

# 3. Verify collection filter canonical:
curl -s "https://yourstore.com/collections/[col]?sort_by=price-ascending" \
  | grep 'rel="canonical"'
# Should output: <link rel="canonical" href="https://yourstore.com/collections/[col]">

If step 3 returns the full URL including query parameters, your theme is breaking Shopify's canonical handling. This is a common issue with custom themes that override theme.liquid's canonical logic. Fix: in theme.liquid, ensure the canonical URL uses canonical_url Liquid tag rather than request.origin | append: request.path (the latter includes query params).

FAQ