A new product that isn't agent-ready from day one is an invisible product. This playbook walks you through the setup sequence to ensure your listing is fully structured for AI discovery before you drive any traffic to it, so you're not playing catch-up after launch.
Goal: The product scores "Excellent" on the Catalog Health Tracker before the launch date.
Time to complete: 45–60 minutes on launch day.
Features used: My Store → Catalog Guardrails · My Store → Product Listing Editor · My Store → Catalog Health Tracker · My Store → Agentic Product Listing (APL) · Prompt Libraries
Step 1: Check Your Guardrails Before You Add the Product
My Store — Catalog Health Tracker with the Catalog Guardrails settings button (top-right)
Guardrails define what a healthy listing means for your catalog. Review them before adding a new product so you build to the right standards from the start.
Go to My Store.
Click the Catalog Guardrails button in the top-right of the Catalog Health Tracker.
Review the active scoring criteria. Turn off any that don't apply to your catalog. For example, if you don't use tags for product discovery, leave tag validation off. This ensures your health score reflects real gaps, not false ones.
Check the Accepted Category Types list includes the category your new product belongs to, and note the description word count thresholds (default: 300–2,000 words).
Click Save settings when your thresholds look right.
Step 2: Build the Listing to the Right Standards
Product Listing page — Organization panel showing category taxonomy, metafields and description fields
Once the product is live in Shopify (even as a draft), open it in My Store and complete every field agents rely on.
In My Store, find your new product and click Fix Now to open the Product Listing page.
In the Category field, set a full taxonomy path at least four levels deep, the minimum recommendation for agentic discovery. Use Search Shopify taxonomy categories or click Suggest a better category for an AI-generated recommendation. A shallow category like "Sporting Goods" will fail. Aim for something like "Sporting Goods → Outdoor Recreation → Winter Sports → Ski Goggles", or deeper where the taxonomy allows.
In the Metafields section, fill every field flagged as required for agentic discoverability. The gap count will drop to zero when all required fields are complete.
Write a product description that meets your guardrail minimum (default: 300 words). Structure it to answer the questions a shopper would ask an AI agent: what is it, who is it for, what does it do, and what makes it different.
Add alt text to every product image. The alt text should describe the visual content specifically, not just the product name. Example: "Black frameless ski goggle with mirrored blue lens on a white helmet".
Step 3: Check the Health Score and Fill the Gaps
Return to My Store and click Refresh scores on the Catalog Health Tracker.
Find your new product in the Product Optimization Opportunities table. Check its health badge.
If the score is Mediocre or below, click Fix Now and review the AI Suggestions panel. Each card explains exactly why the current field is underperforming and provides a ready-to-apply replacement. Click Apply to accept the suggestion (or Edit to adjust it first), then click Save to commit the changes to Shopify.
Refresh scores again. Repeat until the product reaches "Excellent".
📌 Note: You're aiming for Excellent before publishing publicly. A Bad or Poor listing will suppress agentic visibility from day one, and the traffic you drive won't convert at the rate it should.
Step 4: Create an Agentic Product Listing on Launch Day
The Catalog Health score measures your human-facing listing. The Agentic Product Listing (APL) is the separate, agent-optimized version that AI agents read directly. Both matter, so create the APL on or before launch day.
If you don't already have prompts for this product's use case, go to Prompt Libraries and create a new library. Describe the product type and who buys it, then choose your sources: add a subreddit URL, website URL or CSV manually, let AgentIQ Discover subreddits from your Product Catalog, or Select existing sources you've already used in another library. Generation runs in the background, so you can carry on with Step 2 while it works. You can also use the Suggested prompts AgentIQ generates for the product in the next step.
Leave Optimize with keyword volume checked before you generate. This is what gives every prompt a Volume estimate and an Opportunity Score, and it's what you'll sort by two steps from now. Keep the country selector on Auto to follow wherever your store ships, or set it explicitly if you're launching into a specific market.
In My Store, click Create APL next to your new product.
Select three prompts that match how shoppers will ask for this product, and let the data choose them rather than going by feel. The prompt table is sorted by Opportunity from high to low by default, so filter Funnel Step to Purchase and take the highest scores. Purchase prompts are the ones that convert on a launch (for example "best waterproof hiking boots for wide feet" rather than "types of hiking boots"); Discovery and Research prompts are worth targeting later, once you're visible for the ones that close. The Opportunity map shows the same picture visually, with your best targets in the top right.
Don't be thrown by the Ranking column reading 0 for every prompt. That's expected for a product nobody has seen yet. On a launch, Volume and Opportunity are the columns that matter: they separate a prompt worth optimizing against from a phrasing nobody actually types.
Click Run agentic listing. The run takes a few minutes, so click Run in background if you don't want to wait. When it completes, review the generated Unique Selling Point, Agentic Title, Agentic Description and Top Features, and edit inline if needed.
One-time setup: AI agents only see your APLs after the AgentIQ fields are mapped into your Shopify Catalog. If this is your store's first APL, follow Mapping Agentic Product Listings to Your Shopify Catalog. Already mapped? New APLs flow through automatically.
Step 5: Verify Visibility in the Shopify Catalog
Go to Shopify Catalog.
Run your three launch prompts.
Check whether the product appears in the results. If it doesn't surface in the top 10 yet, switch to the My Catalog tab and check the alignment tag. "Unlikely" means there are still structural gaps to close.
Allow 24–48 hours after the APL is applied before re-checking. Listing changes don't surface in the Shopify Catalog immediately.
📌 Note: Once the product has been live for a few weeks, rerun its Prompt Library. Your Ranking and Opportunity Scores will have moved, and the prompts worth optimizing against next are rarely the same ones you launched with.
📌 Note: Repeat this playbook for every major product launch. Products that start agent-ready compound their advantage from day one.
Related Articles