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 Library
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 — create the APL on or before launch day.
If you don't already have prompts for this product's use case, go to Prompt Library and create a new library. A description focused on the product type and buyer intent is enough to generate a starter set in 10–15 minutes. You can also use the Suggested prompts AgentIQ generates for the product in the next step.
In My Store, click Create APL next to your new product.
Select three prompts that match how shoppers will ask for this product. Prioritize purchase-intent phrasing (e.g., "best waterproof hiking boots for wide feet") over research intent (e.g., "types of hiking boots").
Click Run agentic listing. The run takes a few minutes — 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: Repeat this playbook for every major product launch. Products that start agent-ready compound their advantage from day one.
Related Articles