Shopify Catalog Eligibility for Shopping Agent Discovery
How to resolve store requirements, per-product checks, and native field mapping for agentic shopping channels.
Shopify Catalog eligibility depends on distinct store and product conditions. Inspect the documented eligibility reason in your admin before changing discovery files. We organized Shopify's published requirements into separate store, product, and data-layer checks to help merchants isolate why items drop out of artificial intelligence (AI) shopping channels.
The native control surface lives under Sales channels > Agentic. From there, you can inspect your source status, review product data mapping, and repair missing fields without editing your live storefront templates.
Check Shopify Catalog Eligibility for AI Discovery
Shopify Catalog serves as the authoritative product feed for its connected agentic channels, but products only appear when both the store account and the individual items meet documented standards. You can verify your store status by navigating to Sales channels > Agentic > Sources > Shopify Catalog. The panel displays an eligible product count or an Ineligible status message.
Store-level and product-level checks are distinct. According to the official Shopify Catalog requirements, your store must run on a Starter plan or higher, unless you use the separate Shopify Agentic plan. For the regular online-store path, the storefront must be public.
Account standing, genuine sales history, fulfillment performance, and verified paid invoices are evaluated over time, and Shopify provides no fixed approval timeframe.
At the product level, each item requires an identifiable published Uniform Resource Locator (URL), a title, at least one image, and a price greater than zero. Products must be published to active sales channels such as Online Store or Headless with valid routes. Wholesale-only items, unlisted products, products hidden from search engines, and sensitive or ineligible categories are excluded entirely.
A store-level Ineligible warning does not mean its public products are invisible to open-web crawlers.
Fix Shopify Catalog Product Data at Its Source
Channel mapping lets you adjust how product information reaches AI shopping channels without altering your customer-facing theme. Open Sales channels > Agentic > Sources > Shopify Catalog, and click Review product data mapping to open the Shopify Catalog mapping screen.
Default field sources are often sufficient for standard catalogs. The interface displays Field coverage metrics to show how many products currently have values for each attribute. When coverage is incomplete, a Fix products link directs you to the specific items missing critical information.
You can map titles and descriptions to custom metafields or combine text as supported. If an assigned custom source field is empty for a particular item, Shopify Catalog automatically falls back to the default storefront product value. Saving new channel mappings triggers background processing, so preview updates do not appear instantly across connected surfaces.
Match Shopify Catalog Eligibility and Mapping Warnings to the Correct Action
Different eligibility errors require action at either the account, product, or data-mapping layer. The table below outlines documented causes and the required remedies based on published Shopify documentation.
| Observed Symptom | System Layer | Documented Cause | Exact Action | Verification Point | Operational Limit |
|---|---|---|---|---|---|
| Catalog shows Ineligible at store level | Store account | Storefront password active or unapproved plan | Remove storefront password in Online Store preferences or upgrade plan | Admin Sales channels > Agentic > Sources | Account review depends on history and has no set approval time |
| Specific product missing from Catalog | Product | Missing image, blank title, zero price, or unpublished URL | Add required media, title, positive price, and publish to active sales channel | Products > All products > Sales channels | Excluded and sensitive product categories cannot be made eligible |
| Business-to-business (B2B) items omitted from agent feeds | Product | Item configured exclusively for business-to-business wholesale | Keep B2B-only items excluded, or verify genuine direct-to-consumer (D2C) pricing for products sold both ways | Product pricing settings | Pure B2B-only products are excluded from Shopify Catalog |
| Product title missing custom attribute | Channel data | Source field unmapped or custom metafield contains blank value | Map attribute in Review product data mapping; rely on standard fallback | Field coverage indicator | Category taxonomy cannot be overridden through field mapping |
| Compare-at price missing in preview | Channel data | Compare-at value is equal to or lower than current Price | Review list-price source and use a genuine higher compare-at price, or keep Price if none exists | Product pricing section | Downstream AI channels decide whether to render strikethrough prices |
| Headless products not appearing | Store account | Missing public route structure on custom front end | Publish valid product URLs matching your headless framework setup | Agentic sources preview | Headless agentic performance analytics are currently unavailable |
Map Titles and Descriptions Without Rebuilding Product Pages
Product mapping allows you to customize the text sent to AI agents without editing customer-facing page templates. You can assign product fields, custom metafields, or combined text blocks directly inside the channel mapping dashboard.
Category assignments cannot be mapped or overridden through the Shopify Catalog mapping interface. Changing a title or description source does not create a category-mapping control. When you designate a metafield for your description, ensure your inventory data contains complete records across all stock-keeping units (SKUs).
If a mapped metafield is empty, Shopify Catalog automatically falls back to the default storefront description for that product. Inspect multiple representative products after saving changes to confirm that your custom data flows correctly into the feed preview.
Show Sale Prices with the Right List Price
List prices inform shopping agents whether an item is being offered at a promotional discount. Under Shopify Catalog mapping, your list price can be mapped to either the current selling Price or the Compare-at price.
Shopify Catalog uses a selected Compare-at price only when it exceeds Price. In a hypothetical example with Price $40 and Compare-at price $50, choosing Compare-at price supplies a $50 list price. A Compare-at value at or below Price is ineligible.
| Selected List Price Source | Current Price | Compare-at Value | Documented List Price Rule | Display Limit |
|---|---|---|---|---|
| Price | $40 | None or $0 | Current Price $40 | AI channel chooses display |
| Compare-at price | $40 | $50 | Eligible Compare-at $50 | Strikethrough may be displayed |
| Compare-at price | $40 | $35 | Compare-at value is ineligible because it is below current Price | Do not assume a fallback or discounted display |
A valid Compare-at price can support strikethrough pricing. Shopify does not guarantee discounted formatting or changes to search rankings on external AI channels.
Group Variants Without Overriding the Wrong Data
Variant grouping determines how product options like size, material, and color appear to AI discovery systems. Inside channel mapping, custom variant grouping settings override Shopify Combined Listings grouping specifically for the Shopify Catalog feed.
Alternative grouping rules and product option names should reflect your actual product catalog. If your default grouping accurately reflects your product options in Catalog preview, leave the default grouping settings intact.
Modifying grouping rules inside the Agentic sales channel changes only the data feed sent to AI partners. It does not alter your underlying storefront layout, your product URLs, or your customer-facing product option templates.
Keep Catalog Separate from Discovery Files
Shopify Catalog functions as a structured product feed, while site-level text files guide general web crawlers. Your store automatically serves /agents.md, /llms.txt, and /llms-full.txt from its domain root to outline site policies, sitemaps, and discovery endpoints.
Editing discovery files does not correct missing product images, resolve plan restrictions, or alter your product feed mappings. Customize root Markdown files with our Shopify discovery files guide. For broader account-level channel toggles, checkout controls, and external platform connections, review Shopify agentic storefront settings.
Use the native Knowledge base under Sales channels > Agentic for up to 1,000 non-product facts, including policies, shipping, and contact details. It replaces the older Knowledge Base app, closed to new installations and scheduled for deprecation on January 15, 2027. Scanned suggestions stay unpublished until you publish them, while admin-linked facts publish automatically.
Verify the Change Without Predicting Rankings
After saving product updates or field mappings, verify your data using the Search preview tool inside Sales channels > Agentic. The search preview shows raw catalog records alongside listing quality hints, allowing you to confirm that titles, options, and prices match your intended setup.
External AI shopping services re-rank products using proprietary models, meaning that a valid Shopify Catalog status does not guarantee high search placement, visitor traffic, or completed sales. Maintaining high-quality descriptions, clear images, and complete policy records improves data clarity rather than adding arbitrary keyword stuffing. Review product-page feed hygiene for broader structured-data checks.
If your store or products remain ineligible, systematically verify your account status, active pricing, and channel publication. Our diagnostic approach changes if Shopify revises channel eligibility, your store's data architecture changes, or partner AI channels revise technical requirements. Open Sales channels > Agentic to check Shopify Catalog eligibility and your product mappings.
Frequently Asked Questions
- Shopify Catalog eligibility is the set of store and product conditions required for items to appear in native AI shopping channels. Use Starter or higher with a public storefront, or the no-monthly-subscription Agentic plan with external public product URLs. Account review takes time, and published products need valid URLs, titles, images, and positive prices.
- Open your Shopify admin, navigate to Sales channels > Agentic > Sources, locate Shopify Catalog, and click Review product data mapping. This screen allows you to configure source fields for titles, descriptions, and variant grouping.
- Sources > Shopify Catalog displays Ineligible when store requirements fail, such as active passwords, plan limits, or unapproved standing. Individual products are excluded if they lack required fields, URLs, positive prices, or belong to restricted categories.
- No, category taxonomy cannot be remapped or overridden inside the channel mapping interface. The documented source controls apply to the product title and description.
- No, llms.txt and agents.md files provide high-level discovery links and policies for web crawlers. They do not supply structured product feeds to AI shopping channels and cannot resolve missing product fields or catalog eligibility issues.
- Shopify Catalog only uses the Compare-at price as the list price when its numerical value is strictly higher than the current selling Price. If the Compare-at value is equal to or lower than the current price, there is no eligible compare-at list price and the value is ignored.
Need help preparing your e-commerce catalog for AI discovery?
At Layer3Labs, we help operators evaluate AI workflows and technical channel mappings. Request an audit to explore your catalog readiness and agentic configurations.
Book a Consultation