Shopify Agentic Commerce Architecture: What No One Has Documented Yet

Research date: May 2026 | Author: Ramesh Babu J, WAHOO DEVELOPER

This is original research. What follows is not a summary of Shopify's documentation — it is an architectural interpretation built from cross-referencing official docs, developer references, community threads, and live store testing. Where something is documented, we say so. Where it is inferred, we say that too.

The Question That Started This

When we were configuring WAHOO DEVELOPER's store for Shopify Agentic Storefronts — ChatGPT Commerce, Microsoft Copilot, Google AI Mode — we noticed something that Shopify's official documentation doesn't explain cleanly:

What is the actual relationship between Shopify Catalog, Markets Catalogs, and Agentic Storefront activation?

The official eligibility checklist says: sell to US customers, have products in Shopify Catalog, complete your policies, accept the supplemental terms. Simple enough. But when we dug into the developer docs, the Storefront MCP references, and community threads, a more complex architecture emerged — one that no single Shopify document articulates end-to-end.

This post is our attempt to document it.

The Four-Layer Agentic Commerce Architecture

Based on our research, Shopify's agentic commerce infrastructure operates across four distinct layers — each with a different role, different documentation status, and different implications for merchants.

What Shopify has not documented is how these four layers interact with each other in the context of agentic commerce. That is the gap this research addresses.

What We Found — Layer by Layer

Layer 1: Shopify Catalog — The Documented Gate

Shopify Catalog is described as a comprehensive global catalog of eligible products used by Shop, AI platforms, shopping sites, and AI agents. Products are automatically included when store and product requirements are met — no manual action required.

The official agentic storefront eligibility requirements confirm: Shopify Catalog eligibility is the documented prerequisite. Markets Catalogs are not listed as a requirement.

What this means: If your products are in Shopify Catalog and your store sells to US customers, you are eligible for agentic storefronts. Full stop — at the eligibility level.

Layer 2: Markets Catalogs — The Undocumented Context Layer

This is where it gets interesting.

Markets Catalogs are documented as sets of products sold to specific markets — available on all Shopify plans, usable for both B2B and regional markets. The developer docs describe catalog precedence across company-location, region, and app catalogs, with the lowest price selected when multiple catalogs exist for the same market.

But here is the finding that proves Markets Catalogs are not invisible to agentic storefronts:

Shopify explicitly uses B2B Catalogs as a product-eligibility exclusion signal for agentic storefronts.

Shopify's documentation states that agentic storefronts support only D2C sales, and that products sold exclusively to business or wholesale customers are automatically excluded. One of the identification methods is B2B catalogs — products published only to B2B markets or in catalogs assigned to specific companies and locations are excluded from agentic discovery.

This proves an architectural relationship. Markets Catalogs are not an activation requirement — but they are an active filter in the agentic commerce pipeline.

Layer 3: Storefront MCP / UCP — The Query Execution Layer

This is the layer most merchants and even most Shopify Partners don't know exists.

Shopify exposes a per-store Storefront MCP endpoint and a separate UCP (Unified Commerce Platform) catalog endpoint. When an AI agent — ChatGPT, Copilot, or any other — queries for products, it doesn't just read a static feed. It resolves products dynamically using buyer context: country, intent, buyer type.

This means Markets-style contextualization fires at query time, not just at eligibility check time. A US buyer querying ChatGPT for a product from your store triggers a Storefront MCP call that resolves: which products are available in the US market, at what price, in what currency, for what buyer type.

A developer community thread confirmed this: a store with markets, catalogs, and sales channels configured was still returning null product URLs via Storefront MCP. Shopify's response attributed it to storefront password protection — not Markets Catalog configuration. This is actually evidence that Markets Catalogs are not a hard dependency at the MCP layer either, but they are clearly part of the resolution context.

Layer 4: Agentic Channels — The Surface Layer

ChatGPT, Microsoft Copilot, Google AI Mode, and Gemini are the consumer-facing surfaces. They use Shopify Catalog for discovery and Shopify's checkout infrastructure for transaction or referral flow. No special configuration is required at this layer — eligible stores are automatically connected.

The Decision-Grade Conclusion

After cross-referencing official documentation, developer references, and community threads, here is our verdict:

There is no public evidence that Markets Catalogs are a formal prerequisite for Shopify Agentic Storefront activation. The documented prerequisite is Shopify Catalog eligibility.

However, Markets/B2B Catalogs are clearly part of Shopify's product availability, pricing, buyer-context, and B2B-exclusion logic — and they fire at query time via Storefront MCP. They may be co-activated or used downstream once a store is on the newer Markets architecture. The observed correlation between Markets Catalog visibility and agentic storefront activation is plausible as a platform upgrade-path artifact, not yet proven as a strict technical dependency.

The Discover → Context → Transact Framework

The clearest way to communicate this architecture to merchants and Shopify Partners is through what we're calling the Discover → Context → Transact framework:

Discover: Shopify Catalog determines whether your products are visible to AI channels at all. This is the eligibility gate — get this wrong and nothing else matters.

Context: Markets Catalogs, Price Lists, and Publications determine what price, currency, and availability an AI agent resolves when a buyer queries from a specific country or context. This layer is always active — even if you haven't configured it explicitly, Shopify's defaults apply.

Transact: Storefront MCP / UCP is the query execution layer — where buyer context (country, intent) is applied dynamically at the moment an AI agent retrieves or attempts to transact on a product. This is where Markets contextualization becomes operationally relevant, regardless of whether it's listed as an eligibility requirement.

This three-part framework is not documented anywhere by Shopify in this form. It is WAHOO DEVELOPER's original synthesis — built from the architecture up, not from the marketing page down.

How to Validate This — A Three-Store Test

For Shopify Partners and developers who want to validate or challenge this model, here is the test design:

Test 1 — Agentic enabled + Markets Catalogs visible: Check if /admin/markets/catalogs exists and whether default/regional catalogs are assigned. Confirm agentic storefronts are active.

Test 2 — Shopify Catalog eligible, no Markets Catalog configuration: If agentic storefronts activate without any Markets Catalog setup, Markets Catalogs are confirmed as not a hard prerequisite.

Test 3 — Product excluded from US Market catalog, still in Shopify Catalog: Test whether the product disappears from Storefront MCP / AI-channel discovery or only from checkout availability. This determines whether Markets Catalogs affect discovery, checkout, or both.

Test 4 (our addition) — No Markets Catalog assignment at all (store default): If a product with no explicit catalog assignment still surfaces in Storefront MCP with correct USD pricing, this confirms Markets Catalogs are downstream context, not upstream gate.

What This Means for Shopify Merchants

If you are configuring your store for agentic commerce, the checklist is not just "get into Shopify Catalog." The full readiness picture is:

✔ Shopify Catalog eligibility — products have titles, prices, images, standard categories, and your store sells to US customers
✔ Markets configuration — US market active with USD currency and at least one shipping rate
✔ Store policies — ToS, Privacy Policy, and Returns Policy published
✔ B2B catalog hygiene — if you have B2B catalogs, ensure D2C products are not exclusively assigned to them
✔ Storefront MCP readiness — store not password protected, products published to Online Store sales channel

At WAHOO DEVELOPER, we've built this into a structured service: the Agentic Commerce Readiness Audit — a named Expert task that covers all four layers, executed via Shopify Sidekick AI at ₹2,000/task.

Because agentic commerce readiness is not a checkbox. It is an architecture.

Research Limitations and Open Questions

This research has limitations worth stating explicitly:

• The Storefront MCP / UCP architecture is documented in developer references but not in merchant-facing help docs — it may change without notice
• The catalog precedence rules (company-location > region > app, lowest price selected) are documented but their interaction with agentic channel pricing has not been empirically tested by WAHOO DEVELOPER
• The four-store validation test described above has not been completed — this remains a hypothesis, not a confirmed finding
• Shopify's agentic rollout is ongoing — eligibility rules, channel availability, and architecture may evolve

We will update this post as we complete the validation tests and as Shopify's documentation evolves.

Research by Ramesh Babu J, Founder, WAHOO DEVELOPER. Conducted May 2026. All architectural interpretations are WAHOO DEVELOPER's original synthesis unless otherwise attributed.

👉 Book an Agentic Commerce Readiness Audit → ₹2,000/task. Executed via Shopify Sidekick AI.