How to read what Shopify’s catalog says about your product

Your product editor shows what you wrote. It doesn’t show what Shopify Catalog hands to AI agents, and those two texts can differ. This guide covers three ways to read the catalog’s record for a product, in order from easiest to most technical, and what to do with it once you have it.

Start with what you’re trying to read

A catalog record isn’t a copy of your listing. Shopify’s developer docs say product records include title, description, price range, media and normalized options, and that some fields are marked Inferred, meaning Shopify “generated or enriched” them (Global Catalog MCP). The inferred fields are description, options, metadata.attributes, metadata.tech_specs, metadata.top_features, metadata.unique_selling_points and variants[].condition.

So the text worth reading is the description and the three metadata lists of features, specs and selling points. Those are the lines an agent can repeat to a shopper as if you had written them. We go through each field in What Shopify’s AI adds to your listings.

Route 1: the search preview in your admin

The lowest-effort option is inside Shopify. Under Sales channels > Agentic, there’s a search tool that shows “the raw outputs of Shopify Catalog search” for a query, along with listing-quality indicators (Managing agentic storefronts).

Type a query a shopper might use, find your product in the results, and note what’s shown. It’s useful for two things: confirming that the product appears at all, and seeing how it ranks against similar products.

It has limits. It’s built for ranking, so it won’t put an inferred claim next to your own copy, and it won’t tell you which lines were written by Shopify. Shopify also notes that channels “often re-rank results based on their own logic,” so the preview may differ from what shoppers see. If a product doesn’t appear, the cause is usually one of the catalog requirements.

Route 2: the Catalog API

Shopify publishes the same catalog as an API for people building agents. There are two versions. The Global Catalog searches across Shopify merchants, and the Storefront Catalog covers a single store at https://{storeDomain}/api/ucp/mcp (Storefront Catalog MCP). Both expose three tools: search_catalog, lookup_catalog and get_product.

For reading one product you already know, lookup_catalog is the fit. Shopify describes it as the tool to use when you already have product identifiers from earlier searches, shared links or stored references, and says it returns fresh data without another search. The Global Catalog takes up to 50 identifiers per request and the Storefront Catalog up to 10. Identifiers that can’t be found are reported in messages (About Catalogs). The Global Catalog reference lists three accepted formats: a gid://shopify/p/{upid} product ID, a gid://shopify/ProductVariant/{id} variant ID, and a Shopify product URL.

Access isn’t a single click. Every Storefront Catalog request has to include a meta.ucp-agent.profile URL pointing to an agent profile. Shopify’s Global Catalog walkthrough has you get an access token with a search scope, create a catalog in the Dev Dashboard, and send a POST request to its MCP endpoint (Discover products with Shopify Catalog). That’s developer work, and if you don’t have a developer, this route probably isn’t for you.

If you do go this way, keep Shopify’s usage notes in mind. The docs say not to cache results or reuse images, that requests are rate limited, and that API URLs are subject to change. The response also comes back as structured JSON, which shows you the text but doesn’t check it against anything.

Route 3: a comparison instead of a raw record

Reading one record is a start. Reading it usefully means putting each claim next to your own copy and asking whether you ever said it. Done by hand across a catalog, that’s slow, and easy to get wrong by skimming.

That comparison is what Hearsay does. It reads the catalog’s description, top features, tech specs and selling points, splits them into single claims, and checks each against your description, tags, product details and product page (how we check). It shows both texts quoted in full, so you can judge the finding yourself. It reads Shopify’s catalog, not each agent’s answers, and its AI reviewers can be wrong, which is why the quotes are there.

What to look for once you have the record

Whichever route you use, read the record for these:

• Claims about health, safety, age or what’s in it. These matter most. “Fragrance-free,” “suitable from birth” and “non-toxic” are short lines that get repeated as fact.
• Numbers. Ages, sizes, counts and SPF. A dropped qualifier can turn “ages 4 and up” into something else.
• Anything you don’t recognize. A feature or selling point that appears nowhere in your description came from somewhere else. It may be true. It may not.
• What’s missing. A fact you consider central that the record leaves out.

For each one, decide whether it’s accurate. If it’s accurate but you never said it, consider saying it in your own words. If it’s wrong and your copy is already clear, the claim is Shopify’s, and you can’t edit it directly. The options that remain are on your side of the pipeline, covered in AI getting your product wrong? A fix guide.

Because the catalog’s text can change, one reading is a snapshot. Check again after you edit a product, since Shopify says catalog mapping changes “are processed with a delay” (Mapping your product data sources). More guides like this one are under how-to posts.

Common questions

Can I see the catalog record without a developer?

Only in part. The admin search preview needs no code but shows ranking output, not a claim-by-claim comparison. The Catalog API needs an agent profile and, for the Global Catalog, an access token. The free scan is the no-install option: it reads the catalog’s version of 5 of your products and puts each claim beside what you wrote.

Will the record match what ChatGPT or Gemini tells a shopper?

Not necessarily. Shopify says products reach Google AI Mode and Gemini “through the Google & YouTube sales channel or Google Merchant Center” (Selling on Google AI Mode and Gemini), and channels often re-rank results by their own logic. The record shows what Shopify’s catalog offers agents, not what any one agent says.

If I find a wrong claim, what now?

Check your own copy first. Make sure the correct fact is stated plainly in the description, not only in a tab or an image, then look again after the catalog has had time to catch up.