Skip to content

Diagnostic

Why my Shopify store isn't showing up in AI search

Published

The Shopify AI visibility diagnostic in five gates

When a Shopify store doesn't show up in AI search, the cause is one of five things in this order: Catalog eligibility, per-channel access settings, robots.txt.liquid AI-bot blocks, product-data quality against Shopify's seven AI-input categories, or category capture. The cheapest checks come first. Most stores find their cause in gate 1, 2, or 3 — single-digit minutes to fix. Gates 4 and 5 take longer.

The diagnostic order synthesises Shopify's own Catalog1, Catalog requirements2, Catalog-optimization3, Agentic Storefronts admin5, and robots.txt.liquid6 pages.

Gate 1 — Catalog eligibility

Most stores pass eligibility. The ones that don't typically fail on three things: password protection (a dev setting left on in production), shipping country (a store that ships only outside US/CA), or product status (Draft, Archived, or Unlisted instead of Active). Open the eligibility article for the full eleven gates. Five minutes to walk through them on a typical store.

If eligibility fails, fix it first — every product is excluded from Catalog until the store passes. AI surfaces have nothing to surface.

Gate 2 — Channel access in admin.shopify.com/agentic

Open admin.shopify.com/agentic. Confirm the channels you expect to surface in have Catalog access toggled on. Merchants who silently disabled a channel during setup forget about that decision months later — this is where it shows up. Direct checkout setting matters separately for in-chat conversion but doesn't affect whether the channel surfaces the product card at all.

Per Shopify14: Catalog access off means the channel can't recommend the product. Direct checkout off means the channel can still recommend but the buyer is routed to the storefront to complete.

Gate 3 — robots.txt.liquid AI-bot audit

Open the theme code editor. Look for templates/robots.txt.liquid. If the file is present, audit for Disallow rules under any AI bot user-agent. The 2024-era 'block AI bots' templates that circulated widely are the most common cause of eligible-but-invisible. Removing the rules restores access; crawler lag is typically days.

Per Shopify's editing-robots help page6, the file is optional — absent means defaults apply (all AI bots allowed). Present means you have an opinion that may need updating.

Gate 4 — Product data quality against Shopify's seven AI-input categories

Open three random top-revenue products. Score each against Shopify's seven AI-input categories: detailed specifications, comparison information, comprehensive descriptions, structured data, sizing/material/care, price/availability/key features, alt text on every image. A product scoring 3/7 or below is unlikely to surface in AI recommendations even with perfect eligibility and crawler access — the AI doesn't have enough signal to disambiguate it.

The seven categories are from Shopify7. The product data hub walks the rewrite pattern. This gate takes the longest — full PDP rewrites for the top 20 products typically run 1-3 agency days.

Gate 5 — Category capture

If gates 1-4 all pass and the store still doesn't surface, the answer is usually category capture. Some categories have two or three dominant brands holding 80-100% of AI citations. GLP-1 medications: two pharma companies own nearly 100% of citations. Facial skincare: La Roche-Posay holds 81% share. A new entrant in these categories isn't competing on Catalog data — it's competing on editorial citation density on third-party sites, which AI engines train on.

Category capture is the hardest gate to fix because the fix is editorial, not technical. The category capture article walks the documented cases and the playbook.

The diagnostic checklist

Walk these in order. Stop at the first failing gate. Fix it. Re-run from the top. Most stores find the cause in gates 1-3 and never need to walk gates 4-5.

  1. Gate 1: Catalog eligibility checklist (11 gates). Pass before proceeding.
  2. Gate 2: Channel access in admin.shopify.com/agentic. Confirm channels are toggled on.
  3. Gate 3: robots.txt.liquid audit. Confirm OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot are NOT blocked.
  4. Gate 4: Score 5 random products against the seven AI-input categories. Aim for 6+/7.
  5. Gate 5: If gates 1-4 pass, audit for category capture — open category queries in ChatGPT and Perplexity, note who dominates.