This playbook walks you through the exact steps to improve agentic visibility for a single hero product — from building the right Prompt Library to generating an Agentic Product Listing optimized for the queries that matter.
Goal: Your product appears in the top 10 results when you run your target prompts in the Shopify Catalog.
Time to complete: 30–45 minutes for a first run. Faster once your Prompt Library is set up.
Features used: Prompt Library · Shopify Catalog · My Store → Agentic Product Listing (APL) · My Store → Product Listing Editor
Step 1: Build a Prompt Library for Your Hero Product
Prompt Library — Name and Describe your library before generation
Before you can optimize, you need to know what shoppers are actually asking AI agents. A Prompt Library turns real community discussions and search data into the exact prompts you'll use throughout this playbook.
Go to Prompt Library in the left navigation and click + New Library.
Give it a clear name — use the product name or use case (e.g., "Winter Ski Goggles — Hero Product").
Write a description that briefs the agent: name the product, who buys it, and what kind of shopper conversations you want to surface. This description drives every step of the generation pipeline, so be specific.
Click Next to go to Add Sources.
Add Sources
Choose one or more of these approaches:
Discover Subreddits automatically — click Discover Sources. AgentIQ reads your catalog, maps buyer personas, and surfaces relevant subreddits. Filter by category (Buying Advice, Enthusiast Community, etc.), check the communities that fit, and click Done.
Add a subreddit manually — paste a subreddit URL (e.g., reddit.com/r/skiing) if you already know where your buyers talk.
Upload a CSV — import pre-written prompts directly, such as your query export from Google Search Console.
Once at least one source is added, click Generate Library. Generation runs in the background — you can leave the page and return when the status shows "Ready".
Step 2: Check Your Current Ranking in the Shopify Catalog
Shopify Catalog — Results grid showing rank badges and the "My product" indicator
Before you optimize, establish a baseline. You need to know where your product currently stands — and who you're losing to.
Go to Shopify Catalog.
Click the Prompts button to the left of the search bar and select two or three prompts from your new library.
Click Run for each prompt.
Look for the green "My product" badge in the results. If your product doesn't appear in the top 10, note which competitors are ranking and what signal badges they carry (Best price, Most reviewed, Top rated).
Hover over a top-ranking competitor's card and open the How Agents Choose overlay — this shows exactly which listing attributes drove that position.
Click any competitor's card to open the full Product Detail Panel and review their description, top features, and structured attributes.
You now have a clear picture of the gap you're closing.
Step 3: Generate an Agentic Product Listing
The Agentic Product Listing (APL) is a separate, agent-optimized version of your product that lives as Shopify metafields. It's what gives AI agents the confidence to recommend your product over a competitor's — and it doesn't touch your human-facing product page.
Go to My Store and find your hero product in the Product Optimization Opportunities table.
Click Create APL in the Agentic product listing column. (If the product already has one, click View APL and use Edit prompts to rerun.) This opens the three-step flow: Prompts → Run → Review.
Select up to three prompts — from Suggested, your Library, or typed manually. Prioritize high-intent prompts — queries where a shopper is ready to buy, not just researching.
Click Run agentic listing. AgentIQ searches the Shopify Catalog for each prompt, studies the top-ranked competitor listings and writes your optimized version. The final re-index step can take a few minutes — click Run in background if you don't want to wait.
On the review page, read every generated field — Unique Selling Point, Agentic Title, Agentic Description and Top Features — and check the Top competitors surfaced panel to see which listings AgentIQ studied. Edit any field inline if it needs adjustment.
Important! One-time setup: AI agents only see your APLs after the AgentIQ fields are mapped into your Shopify Catalog. After creating your first APL, follow Mapping Agentic Product Listings to Your Shopify Catalog. Every APL you create afterwards flows through automatically.
Step 4: Apply Product Listing Recommendations
Product Listing Editor — AI Suggestion card showing impact level and a ready-to-apply fix
Creating the APL is half the work. The other half is fixing the human-facing product page based on what AgentIQ learned from your competitors. The Product Listing Editor surfaces inline suggestions for descriptions, titles, metafields, and image alt text.
From the APL review page, click Product listing — or click Fix Product next to the product in My Store.
Review each suggestion card. Each one shows the impact level (Medium or High), why it's suggested, and a proposed replacement.
For each suggestion, click Apply to accept the proposed text, Edit to adjust it first, or Dismiss to reject it. When you're done, click Save in the top bar to commit your changes to Shopify.
Pay particular attention to: category depth (aim for at least four taxonomy levels), image alt text, and description length and structure.
📌 Note: Unlike the APL, changes here do affect your visible product page — review the text before applying. A deep, accurate category taxonomy is one of the strongest ranking signals for AI agents. "Ski & Snowboard Goggles" performs significantly better than "Sporting Goods" for intent-driven queries.
Step 5: Verify Your Ranking Has Improved
Return to Shopify Catalog.
Run the same prompts you tested in Step 2.
Check for the green "Listed in Top 10" banner. If it's there — you're done.
If you're not ranking yet, open the product in My Store and check the Prompts Analysis panel with one of your target prompts to see which specific gaps remain. The Analysis Results panel will call out exactly what's holding the listing back.
📌 Note: Allow 24–48 hours after applying updates before re-running your prompts. Product listing changes don't surface in the Shopify Catalog immediately.
Related Articles