Skip to content

Cluster 2G · the diagnostic

The Shopify AI visibility diagnostic flowchart

Five gates, in order: Catalog eligibility, channel access, robots.txt.liquid, product-data quality, category capture. The cheapest checks run first; the hardest one — category capture — runs last because it's also the hardest to fix.15 Walk the five in sequence and you have your answer.

Published

The diagnostic flow

The eligible-but-invisible problem has five common causes, in descending order of frequency and ascending order of cost-to-fix. Catalog eligibility (mechanical, fix in minutes). Per-channel access settings (admin toggle, fix in minutes). robots.txt.liquid AI-bot blocks (theme code edit, fix in 15 minutes). Product-data quality (PDP rewrites, fix in days). Category capture (citation density, fix in months). Walk them in that order; you'll find the cause before you get to the hardest gate.

The five-step flow synthesises the eligibility doc2, the channel-control documentation14, the robots.txt.liquid surface6, the product-data optimization list38, and the field evidence on category capture. Each step has its own page below.

The diagnostic order

Minutes

to fix Catalog eligibility once you've identified the failing gate.

Shopify Help · 2026-05-22
15 min

to audit and fix the robots.txt.liquid AI-bot block trap.

Shopify Help · 2026-05-22
Days

to do the PDP rewrites against Shopify's seven AI-readable fields.

Shopify Help · 2026-05-22

1. Catalog eligibility

Open Shopify admin. Confirm the store is on the Starter plan or higher, not password-protected, and ships to the United States or Canada. Open three products. Confirm each has a title, at least one image, a price over $0, an identifiable URL, and is not set to Unlisted status. If any one of those eleven gates fails, the product is out of Catalog — and out of every AI surface that reads it.

The eligibility list is verbatim from Shopify2. Most stores pass this gate. The ones that fail it typically miss one of two: password protection (a development setting forgotten in production) or country shipping (a store shipping only to Australia, for example, with no US/CA option).

2. Channel access

Open admin.shopify.com/agentic. Review which AI channels are enabled. Confirm the products you expect to surface in (say) ChatGPT or Perplexity have the Shopify Catalog access toggle enabled for that channel and the Direct checkout toggle set the way you want. Merchants who silently disabled a channel in setup forget about that decision six months later — this is where it shows up.

The verbatim Shopify framing1: "you can't opt out of Shopify Catalog itself" but "merchants can selectively block individual AI channels from accessing their products through Shopify Catalog controls ('Shopify Catalog access' and 'Direct checkout' settings)." The new admin page5 makes both toggles visible on one screen.

3. robots.txt.liquid audit

Open the theme code editor. Look for templates/robots.txt.liquid. If the file is absent, Shopify defaults apply — the store allows AI crawlers, and this gate passes. If the file is present, audit it for Disallow rules under any of these user-agents: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Google-Extended. Pasted-in 2024 'block AI bots' templates are the most common cause of eligible-but-invisible.

Shopify's edit-robots help page6 documents the file and its risks; the dev docs7 document the Liquid object syntax. The AI crawlers cluster hub walks the per-bot rules and the templates merchants paste in by accident.

4. Product-data audit

Open three 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, and alt text on every image. A product missing any three of these is unlikely to surface in AI recommendations regardless of Catalog eligibility — there isn't enough structured signal for the AI to disambiguate.

Shopify's optimization list8 is the score card. The product data hub walks each category and the rewrite pattern. This gate takes the longest — full PDP rewrites against the seven categories typically run 1-3 days per store at agency pace.

5. Category capture

If gates 1-4 all pass and the products still don't surface, the answer is usually category capture. In some categories, two or three brands hold 80%+ of AI citations. GLP-1 medications: two pharma companies own nearly 100% of citations across ChatGPT, Claude, and Perplexity. Facial skincare: La Roche-Posay holds 81% share. A new entrant in these categories isn't competing on product data — it's competing on editorial citation density on third-party sites, which AI engines train on.

The category-capture diagnosis is the hardest one because the fix is editorial, not technical. The category capture article walks the documented cases and the playbook for breaking in — earning citations on category-specific publications, dermatologist-credentialed review sites, and the long tail of independent reviewers AI engines weight as authoritative sources.

The 4 articles under this cluster

Four articles cover the diagnostic in depth. The 'not showing up' article walks the long-form flowchart with every step. The category-capture article covers gate five specifically. The AI visibility check tool article describes the criteria a real check should cover. The 30-day report article shows what an audit report should output.

  1. DIAGNOSTIC Shopify not showing up in AI search Why my Shopify store isn't showing up in AI search The diagnostic flowchart in long form. Five gates, in order, with the Shopify-emitted reference for each. 11-min read
  2. EXPLAINER category capture AI shopping Category capture — when one brand owns 80%+ of AI recommendations Documented for GLP-1 (two pharma own ~100% of citations) and beauty (La Roche-Posay 81% facial skincare). When category capture is your real diagnosis. 10-min read
  3. REFERENCE Shopify AI visibility checker Free Shopify AI visibility checker (lead-magnet hub) The criteria a real AI-visibility check should cover: Catalog eligibility, channel access, robots.txt.liquid, schema, product data, and AI prompt testing. 6-min read
  4. REFERENCE Shopify 30-day AI visibility report What a 30-day Catalog visibility report should contain Inside the Agentic Storefronts admin: ranking queries, channel performance, product-data recommendations. The report template a 30-day audit should output. 8-min read
  1. DIAGNOSTIC Shopify not showing up in AI search Why my Shopify store isn't showing up in AI search The diagnostic flowchart in long form. Five gates, in order, with the Shopify-emitted reference for each. 11-min read
  2. EXPLAINER category capture AI shopping Category capture — when one brand owns 80%+ of AI recommendations Documented for GLP-1 (two pharma own ~100% of citations) and beauty (La Roche-Posay 81% facial skincare). When category capture is your real diagnosis. 10-min read
  3. REFERENCE Shopify AI visibility checker Free Shopify AI visibility checker (lead-magnet hub) The criteria a real AI-visibility check should cover: Catalog eligibility, channel access, robots.txt.liquid, schema, product data, and AI prompt testing. 6-min read
  4. REFERENCE Shopify 30-day AI visibility report What a 30-day Catalog visibility report should contain Inside the Agentic Storefronts admin: ranking queries, channel performance, product-data recommendations. The report template a 30-day audit should output. 8-min read

Keep reading