{
  "id": "D05",
  "url": "https://cartforagents.com/guides/shopify-global-catalog",
  "title": "Shopify Global Catalog: distinguish products, UPIDs and seller offers",
  "description": "Tell search results, UPID clusters, variants and seller offers apart in Shopify's Global Catalog, with an identity diagram and the unit to use for every count.",
  "answer": "In Shopify's Global Catalog, a product is a cluster under one Universal Product ID (UPID), and each variant inside it is a purchasable item with its own price, stock, checkout link and seller, so one product can carry offers from several shops. Count search results, UPIDs, variants and sellers as four separate units, and say which one every number uses. Catalog search order is not the assistant's final recommendation: Shopify says agentic storefronts re-rank, and OpenAI says ChatGPT ranks the merchants offering a product on factors such as availability, price, quality and being the maker or primary seller.",
  "take": "Count the unit you mean. \"Ten results\" can be ten products or one boot listed seven times, and decisions made on the wrong count are wrong decisions.",
  "summary": "In Shopify's Global Catalog, \"a product\" can mean a search result, a cluster of identical items from several shops, one purchasable variant, or one shop's offer of it. Pick the wrong one and every count you make is wrong.",
  "claims": [
    {
      "text": "Shopify says Global Catalog discovery uses search_catalog or lookup_catalog, with results clustered by Universal Product ID (UPID) and including offers from multiple merchants, and that evaluation uses get_product to explore options and retrieve pricing and seller checkout links for the buyer's chosen variant.",
      "source_title": "Global Catalog MCP (Shopify developer documentation), How it works",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Interface documentation for agent builders. It does not say how Shopify decides that two shops' items are the same product."
    },
    {
      "text": "Shopify says lookup_catalog accepts 1 to 50 identifiers (gid://shopify/p/{upid}, gid://shopify/ProductVariant/{id}, or Shopify product URLs), that multiple IDs resolving to the same product are grouped into a single product in the response, and that each variant carries an inputs array for correlation.",
      "source_title": "Global Catalog MCP (Shopify developer documentation), lookup_catalog",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Living documentation; we did not run a lookup for this article."
    },
    {
      "text": "The Universal Commerce Protocol catalog specification defines a product as a catalog item with one or more purchasable variants, and a variant as a purchasable item with option selections, price and availability, with optional seller context; it says businesses should return the most relevant variant first (the best match for the query and context in search), and platforms should treat the first element as featured.",
      "source_title": "Universal Commerce Protocol: Catalog specification (2026-08-25), Product and Variant",
      "source_url": "https://ucp.dev/2026-08-25/specification/shopping/catalog/",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "The protocol defines record shapes, not how a platform clusters products or ranks them."
    },
    {
      "text": "Shopify's Global Catalog extension lists variant fields including checkout_url, eligible.native_checkout (default false), availability.running_low, and seller.id (the shop GID), seller.url and seller.domain, and says seller.name and seller.links are always present for Shopify sellers.",
      "source_title": "Global Catalog extension (Shopify developer documentation), Variant fields",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog-extension",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Describes fields, not which seller an assistant shows."
    },
    {
      "text": "Shopify documents external offers in beta: products indexed from merchants' own websites, using the same gid://shopify/p product ID format, gid://catalog/ExternalVariant variant IDs and gid://catalog/ExternalMerchant seller IDs, with no checkout_url, native checkout always false, indicative prices, untracked stock, and coverage currently limited to merchants selling to the United States.",
      "source_title": "Global Catalog extension (Shopify developer documentation), Catalog sources",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog-extension",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Beta; behaviour and fields can change. Shopify says it does not verify external product data. Only API clients Shopify has enabled can request external sources."
    },
    {
      "text": "Shopify says a saved catalog configuration can have promoted placement enabled, and that promoted placements and commission are not available for external offers.",
      "source_title": "Global Catalog MCP and Global Catalog extension (Shopify developer documentation)",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "We have not examined promoted placement. It means some Catalog result orders can include paid placement, which our unpersonalized searches did not request."
    },
    {
      "text": "Shopify says Shopify Catalog automatically structures product data by consolidating variants and grouping identical items; that by default products are grouped using the Shopify Combined Listings configuration; and that a merchant can set up custom grouping in the Shopify Catalog Mapping tool.",
      "source_title": "Customizing your product data for Shopify Catalog (Shopify Help Center)",
      "source_url": "https://help.shopify.com/en/manual/shopify-catalog/mapping",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Covers grouping within your own store. It does not describe cross-merchant clustering."
    },
    {
      "text": "Shopify says agentic storefronts often re-rank Shopify Catalog results based on their own logic, so its admin search preview is a directional signal, not an exact prediction.",
      "source_title": "Managing agentic storefronts (Shopify Help Center), Reviewing your products' discoverability and ranking",
      "source_url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/agentic-home",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Does not describe any assistant's ranking."
    },
    {
      "text": "OpenAI says that when a shopper selects a product, ChatGPT may show a list of merchants offering it, generated from merchant and product metadata, and that merchants are ranked on factors like availability, price, quality and whether they are the maker or primary seller of that item.",
      "source_title": "Shopping with ChatGPT Search (OpenAI Help Center), How merchants are selected",
      "source_url": "https://help.openai.com/en/articles/11128490-shopping-with-chatgpt-search",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Living help page that changes often; re-read on October 27, 2026. Factors are listed without weights."
    },
    {
      "text": "Across 162 searches, the 1,620 results carried 1,612 distinct product IDs; eight IDs appeared in two searches each, seven with the same first variant both times and one with a different variant from the same seller. Every result carried exactly one variant, and the results came from 1,056 distinct seller IDs.",
      "source_title": "Cart for Agents: Ten Catalog results: count products, variants and sellers separately",
      "source_url": "https://cartforagents.com/research/ai-shopping-seller-concentration",
      "source_date": "2026-10-26",
      "method": "observed",
      "limitation": "One unpersonalized search snapshot, top 10 per search. Occurrences, not market products. A distinct product ID is not proof of a distinct physical product."
    },
    {
      "text": "In the same snapshot, 31 titles (compared ignoring case) came back under more than one product ID, 29 of them within a single search; in 20 of the 31 the IDs belonged to different seller IDs, and in 11 to one seller.",
      "source_title": "Cart for Agents: Shopify Global Catalog identity guide (How we checked, this page)",
      "source_url": "https://cartforagents.com/guides/shopify-global-catalog#how-we-checked",
      "source_date": "2026-10-26",
      "method": "observed",
      "limitation": "Matching titles is not matching products. Generic titles, colour listings and genuinely unclustered duplicates all look the same here, and we did not open the pages to tell them apart."
    }
  ],
  "sources": [
    {
      "title": "Global Catalog MCP (Shopify developer documentation)",
      "url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "accessed": "2026-10-27"
    },
    {
      "title": "Global Catalog extension (Shopify developer documentation)",
      "url": "https://shopify.dev/docs/agents/catalog/global-catalog-extension",
      "accessed": "2026-10-27"
    },
    {
      "title": "Universal Commerce Protocol: Catalog specification (2026-08-25)",
      "url": "https://ucp.dev/2026-08-25/specification/shopping/catalog/",
      "accessed": "2026-10-27"
    },
    {
      "title": "Customizing your product data for Shopify Catalog (Shopify Help Center)",
      "url": "https://help.shopify.com/en/manual/shopify-catalog/mapping",
      "accessed": "2026-10-27"
    },
    {
      "title": "Managing agentic storefronts (Shopify Help Center)",
      "url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/agentic-home",
      "accessed": "2026-10-27"
    },
    {
      "title": "Optimizing your products for AI platforms (Shopify Help Center)",
      "url": "https://help.shopify.com/en/manual/shopify-catalog/optimizing-products",
      "accessed": "2026-10-27"
    },
    {
      "title": "Shopping with ChatGPT Search (OpenAI Help Center)",
      "url": "https://help.openai.com/en/articles/11128490-shopping-with-chatgpt-search",
      "accessed": "2026-10-27"
    },
    {
      "title": "Cart for Agents: Ten Catalog results: count products, variants and sellers separately",
      "url": "https://cartforagents.com/research/ai-shopping-seller-concentration",
      "accessed": "2026-10-27"
    },
    {
      "title": "Cart for Agents: 162 shopper searches in Shopify Catalog",
      "url": "https://cartforagents.com/research/agent-shopping-research",
      "accessed": "2026-10-27"
    }
  ],
  "limitations": [
    "Built from Shopify developer and help pages, the Universal Commerce Protocol specification and OpenAI's help page, checked on October 27, 2026. These interfaces change, and external offers are in beta; re-check before acting.",
    "Shopify does not document how it decides that items from different shops are the same product. Nothing here describes that process.",
    "Our snapshot used the search route only, with no buyer context. Every result carried one variant, so we never saw several sellers' offers under one product ID. That is a limit of what we looked at, not evidence that clustering doesn't happen.",
    "Catalog order is not what any assistant showed a shopper. We cannot see assistant answers or merchant lists.",
    "Store and brand names are withheld."
  ],
  "related": [
    "https://cartforagents.com/guides/shopify-agentic-storefronts",
    "https://cartforagents.com/guides/shopify-metafields-ai",
    "https://cartforagents.com/guides/how-to-rank-in-chatgpt",
    "https://cartforagents.com/research/ai-shopping-seller-concentration",
    "https://cartforagents.com/guides/product-variant-structured-data",
    "https://cartforagents.com/research/shopify-catalog-vs-chatgpt-results"
  ],
  "published": "2026-10-27",
  "updated": "2026-10-27",
  "checked": "2026-10-27",
  "kind": "guide"
}