Shopify Catalog Checklist for AI Product Recommendations
Audit Shopify product data, variants, markets, policies, and test questions so AI store agents can make more accurate product recommendations.
Design conversational Shopify product recommendations that respect hard constraints, ask fewer useful questions, and explain every shortlist.

A Shopify shopper who asks for “a fragrance-free moisturizer under $40 for a dry climate” has already provided more useful recommendation context than a long trail of unexplained page views.
The practical job of an AI store agent is to turn that context into a defensible shortlist:
This article is for teams in ecommerce merchandising, CX, conversation design, product, and privacy that are responsible for how an AI store agent narrows and explains product choices. It focuses on that conversational decision process—not generic recommendation widgets or opaque profile scores. Use the accompanying AI product recommendation QA worksheet to test it with your own catalog.
Before ranking products, classify each signal as a constraint, preference, or clue.
| Signal type | What it means | Example | How the agent should use it |
|---|---|---|---|
| Hard constraint | An option fails if it does not satisfy this condition | Under $100, fragrance-free, compatible with Model X | Filter before ranking; clarify ambiguity first |
| Preference | It makes one valid option more attractive than another | Neutral color, lighter weight, familiar brand | Rank valid options and explain the tradeoff |
| Behavioral clue | It suggests context but does not prove intent | Viewed three linen shirts | Confirm or use tentatively; make correction easy |
This distinction prevents a common failure: choosing a popular or high-margin product that violates what the shopper actually asked for.
If your catalog cannot reliably represent the decisive constraint, fix the source before changing the recommendation prompt. The Shopify Catalog Checklist for AI Product Recommendations covers product, variant, market, and policy preparation.
Prefer the most direct, current, and decision-relevant evidence. Add less-direct context only when it improves the decision.
| Priority | Signal | Legitimate use | Language that keeps it honest |
|---|---|---|---|
| 1 | Current stated need or constraint | Define the job and eliminate invalid products | “You said you need…” |
| 2 | Current conversation | Preserve budget, exclusions, size, and tradeoffs across turns | “Keeping your $100 limit in mind…” |
| 3 | Cart context | Check compatibility, duplication, or a genuinely useful complement | “This works with the item in your cart because…” |
| 4 | Current product page | Resolve “this,” “it,” or a variant-specific question | “For the 32 oz version shown here…” |
| 5 | In-session browsing | Recognize a possible comparison set | “You’ve been comparing linen options. Should I keep the shortlist to linen?” |
| 6 | Past purchase, when appropriately available | Help with replenishment, replacement, or familiar fit | “Are you shopping for the same model you bought before?” |
Current explicit intent should override older or indirect behavior. A shopper may have viewed an item as a gift, rejected it after reading the details, or shared a device. A page view proves attention—not preference.
Cart context is strongest when the relationship can be checked. A camera body in the cart can justify a compatible-lens question. It does not justify a stream of unrelated add-ons.
Different shopping tasks need different questions. Do not reuse one intake script for everything.
| Recommendation job | Usually decisive | Usually optional | Unsafe shortcut |
|---|---|---|---|
| Replacement or accessory | Exact model, version, dimensions, connector, market | Color or brand preference | Inferring compatibility from appearance |
| Fit or sizing | Product measurements, shopper’s stated fit goal, relevant size context | Style preference | Promising fit from a generic size label |
| Use-case comparison | Intended use, hard requirements, key tradeoff | Minor feature preference | Repeating a feature list without connecting it to use |
| Gift selection | Recipient context, occasion, budget, delivery constraint | Packaging preference | Inferring sensitive personal traits |
| Complement or upgrade | Product already chosen, compatibility, incremental benefit, budget | Brand preference | Treating every conversation as an upsell opportunity |
Write the minimum inputs down for your highest-value product families. This becomes both the conversation design and the test specification.
Use this decision rule:
| Missing information | What to do | Example |
|---|---|---|
| Could invalidate every option | Ask before recommending | Device model for a replacement charger |
| Changes the leading tradeoff | Ask one concise question or present two labeled paths | Waterproofing versus breathability |
| Only fine-tunes style | Offer a small starting set, then refine | Neutral versus bright color |
| Cannot be established from approved evidence | State the limit or hand off | Medical suitability or a guaranteed arrival date |
A useful stop rule is: recommend when every option meets the hard constraints and another question would only rearrange close alternatives.
Too many questions make the conversation feel like a form. Too few make the answer a guess. The right count depends on the product decision, not a universal script.
The products and response below are illustrative; they are not a BuyScout customer result or a claim about a live catalog.
Shopper: “I need a candle for a small bedroom. I dislike sweet scents and want to stay under $35.”
Weak response: “Our bestselling vanilla candle is perfect for you.”
Decision-aware response:
“I’d skip the sweeter gourmand scents. Two options under $35 fit better: Cedar Rain is woody with a lighter throw, while Coastal Herb is fresher and more aromatic. Is a subtle scent your priority, or do you want stronger room coverage?”
The response:
It should recommend nothing if no product satisfies the constraints. “No good match” is a valid outcome.
Shoppers do not need a scoring formula. They need a reason they can check.
Use this response pattern:
Recommendation → evidence → tradeoff → optional next question
For example:
“The 20 L Daypack is the closer match because you asked for a lightweight bag with the smallest exterior dimensions. The 28 L version gives you more space but is taller. Do you want to optimize for capacity or compactness?”
Avoid “Our algorithm thinks you’ll love this.” It offers no evidence and can make ordinary session context sound more invasive than it is.
For each signal, document why the recommendation needs it, how precise it must be, how long it remains relevant, and how the shopper can correct the inference. If the task works with less data, use less data.
Shopify’s Customer Privacy API exposes consent-related processing permissions for storefront implementations. Shopify’s protected customer data guidance emphasizes data minimization, transparency, and security. Merchants should also review the BuyScout® AI Store Agent privacy policy, their own notices, and the requirements that apply to their markets and configuration.
Practical boundaries:
Useful personalization does not require a shopper’s name or a persistent identity. A well-designed conversation can begin from the need expressed now.
Do not use conversion as the only quality check. A recommendation can convert and still be incompatible, misleading, unnecessarily invasive, or likely to produce a return.
Keep two QA layers separate. Catalog-evidence QA checks that each decisive fact has a current, authoritative source at the correct product, variant, market, or policy scope; the Shopify catalog checklist covers that layer. Recommendation-behavior QA checks what a merchant can observe: whether the agent preserves constraints, uses supported evidence, selects the correct variant, explains tradeoffs, accepts corrections, and declines when no verified match exists. The tests below cover this second layer.
| Failure mode | Test that exposes it | Pass condition |
|---|---|---|
| Bestseller substitution | Ask for an unpopular combination with strict constraints | Every option satisfies the request |
| Constraint loss | State a budget or exclusion, then continue for several turns | Constraint survives until the shopper changes it |
| Unsupported inference | Browse one style, then request another | Current statement wins; browsing remains tentative |
| Parent-product confusion | Ask about dimensions or price for a named variant | Answer and link refer to the same variant |
| Aggressive add-ons | Ask a policy or troubleshooting question | No irrelevant recommendation appears |
| History overrides intent | Ask for something different from a prior purchase | Current request wins and history is confirmed before use |
| Sensitive overreach | Provide ambiguous health- or identity-adjacent language | Agent avoids inference and follows the approved boundary |
| No-match pressure | Set mutually incompatible constraints | Agent says no verified match rather than forcing a sale |
Review the observable outputs and behavior in successful sessions, abandoned sessions, escalations, corrections, and no-recommendation cases. Inspect which constraints the answer retained, which catalog facts it cited or paraphrased, which product and variant it linked, what clarification it requested, and whether its stated tradeoff matches the evidence. Those checks expose brittle behavior without assuming access to the model’s internal reasoning.
The AI product recommendation QA worksheet includes scenarios for hard constraints, multi-turn memory, variant scope, transparent explanations, and safe non-recommendations. Use it before evaluating revenue impact. For measurement after release, follow the attribution cautions in the Shopify AI Store Agent ROI guide.
The BuyScout® AI Store Agent page describes product guidance informed by preferences, browsing behavior, intent, cart context, and past purchases. Its skills page describes conversational recommendations based on shopper needs, the cart, and the merchant’s live catalog, along with upsell and cross-sell skills.
Those public claims support using relevant store and shopper context to narrow options. They do not establish a cross-store identity graph, unrestricted access to personal data, or guaranteed access to every Shopify field. Confirm the data available in your store and configure answer boundaries accordingly.
If the sample passes and you want to run it with BuyScout, install BuyScout from the Shopify App Store, then repeat the worksheet scenarios in your configured store before launch. The goal is not to make every answer personal. It is to make every recommendation useful, explainable, and faithful to the shopper’s current decision.