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 library is set up.
Features used: Prompt Libraries · Shopify Catalog · My Store → Agentic Product Listing (APL) · My Store → Product Listing Editor
Step 1: Build a Prompt Library for Your Hero Product
Prompt Libraries — 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 Libraries in the left navigation and click + New library.
Give it a clear name, using the product name or use case (for example, "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 generation, so be specific.
Click Next to go to Add sources.
Add Sources
Choose one or more of these approaches:
Discover subreddits: click Discover. AgentIQ reads your Product Catalog, works out who your buyers are, and surfaces the communities most relevant to them. Filter by type (Buying Advice, Enthusiast Community, and so on), check the ones that fit, and click Done.
Add manually: paste a subreddit URL (for example, reddit.com/r/skiing) or any public website URL if you already know where your buyers talk, or upload a CSV of prompts you already have, such as your query export from Google Search Console.
Select existing sources: reuse sources you've already added to another library. Nothing gets re-crawled, so this is the fastest route.
Leave Optimize with keyword volume checked before you generate. It's what gives every prompt a Volume estimate and an Opportunity Score, which is how you'll choose your targets below. Keep the country selector on Auto to follow wherever your store ships.
Once at least one source is added, click Generate Library. Generation runs in the background, so you can leave the page and return when the status shows "Ready".
Pick Your Target Prompts
When the library is ready, open it. Don't work down the list in order. The table is sorted by Opportunity from high to low, so the prompts worth your time are already at the top.
Opportunity weighs how much demand sits behind a prompt against how well your catalog currently shows up for it. A high score means shoppers are already asking and you have room to climb.
Volume tells you whether that demand is real. A perfectly phrased prompt nobody actually types is not worth optimizing against.
Ranking gives you a head start on Step 2. A 0 means you aren't surfacing for that prompt at all.
The Opportunity map shows the same picture visually, with your best targets in the top right: high Volume, high Opportunity. Pick two or three from there and carry them into the next step.
Step 2: Check Your Current Ranking in the Shopify Catalog
Shopify Catalog — Results grid showing rank badges and the "My product" indicator
The Ranking column in your library already told you whether you show up at all. This step tells you who is beating you, and why.
Go to Shopify Catalog.
Click the Prompts button to the left of the search bar and select the two or three prompts you shortlisted.
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. Use the ones you shortlisted from the Opportunity map. If you want to weight the listing toward shoppers who are ready to buy rather than still researching, filter Funnel Step to Purchase and take the highest Opportunity scores from there.
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, so 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, so 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.
Rerun the library after a few weeks. Your Ranking and Opportunity scores will have moved, and the next prompts worth optimizing against are rarely the ones you started with.
📌 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