Skip to main content

Prompt Libraries

This is where you build and manage the real-world prompts you'll test your catalog against. Libraries are generated from actual customer discussions, Reddit communities, public web sources, Google Search Console (GSC) queries, or your own CSV files.

Grounding test cases in real shopper language, instead of internal guesses, is what makes the difference. Each prompt comes with a Volume estimate and an Opportunity Score, so you know exactly which prompts are worth optimizing for first when you're building out your Agentic Product Listings. That's how Prompt Libraries surface your demand gaps and get your Product Catalog ready to win with AI shopping agents.

The Libraries List

The Prompt Libraries index, with status, prompt count and creation date for every library

The main Prompt Library page is your index of every library you've created. Each row shows:

  • Name: the library's title, linking to its detail view

  • Source Type: where the prompts came from, such as "From Sources", "CSV Import" or "Auto-Discovered"

  • Status: "Ready" once generation is complete, "Processing" while prompts are still being generated, or "Failed" if a run did not complete

  • # Prompts: the total number of prompts in the library

  • Created At: the generation date

  • Actions: view (eye icon), edit (pencil icon) or delete (trash icon), per row

Use the pagination controls at the bottom to browse your libraries. Click + New library in the top right to start the creation wizard.

Creating a New Library

New libraries come together in a four-step wizard: Name & describe, Add sources, Generate and Done.

Step 1: Name & Describe

Step 1, library name and description with the four-step progress indicator

Library name: a short, identifiable label used across the index and your tracked prompts.

Description: a plain-language brief on what you're testing for. Describe your product, target buyer personas and the topics you want covered, the way you'd brief a researcher.

Be specific here. This description shapes every part of how the library gets built, from the sources it looks at to the prompts it pulls out, so the more clearly you describe your product and buyers, the more relevant your results will be.

Click Next to move on to Add sources.

Step 2: Add Sources

Step 2, three ways to add sources plus the keyword volume option

Sources are the raw material your prompts get built from. You have three ways to add them, and you can combine them:

  • Add manually: paste a subreddit URL (for example, reddit.com/r/snowboarding), paste any public website URL, or upload a CSV of prompts you already have, like your Google Search Console queries.

  • Discover subreddits: we read your Product Catalog, work out who your buyers are, and surface the communities most relevant to them. No manual research needed.

  • Select existing sources: reuse sources you've already added to another library. Nothing gets re-crawled, so this is the fastest option.

Optimize with keyword volume

Leave this checked to rank every prompt by real search demand and tie each one to a specific product to fix. Choose which country's shopper demand to measure against, or leave it on Auto to follow wherever your store ships. Each run draws on your search-data allowance.

Discovery results

Discovery results, filterable by community type

When discovery finishes, you get a panel of communities with a type tag, member count and a short note on why each one is relevant to what you described in Step 1. Filter by type (All, Buying Advice, Enthusiast Community, Lifestyle) to find the best fit, check the ones you want and click Done to add them to your source list.

Once at least one source is added, Generate library activates.

Step 3: Generate

Click Generate library. Generation runs in the background with a real-time progress indicator, and the time it takes scales with how many sources you added. Feel free to navigate away. We'll keep working, and the library status updates to "Ready" when it's done.

Step 4: Done

When it's done, you get a confirmation screen with a Ready status badge. Click View library to see your results, or Create another to start a new one.

Library Preview & Analytics

The Library Preview gives you full visibility into your generated prompts, with intent classification and demand metrics for each one.

The Opportunity Map

The Opportunity map, plotting every prompt by volume against opportunity score and colored by funnel step

The Opportunity map plots your prompts by search demand against how well your catalog is currently showing up for them, colored by funnel step: Discovery, Research or Purchase.

Prompts in the top right are your best bets: real demand, real buying intent, and room for your catalog to close the gap. Use the map to spot which clusters to prioritize before you dig into the table below. Expand How each prompt is ranked for more on what feeds the score.

The Prompt Table

The prompt table, sorted by Opportunity from high to low

Prompts are sorted by Opportunity from high to low by default, so the biggest wins are already at the top. Each column tells you something different:

  • Prompt: the exact natural language question a shopper would type to an AI agent

  • Category: the product area the prompt belongs to, such as Jackets, Boots, Gloves or Helmets

  • Sub-intent: the specific need behind the prompt, like "find lightweight" or "compare lightweight"

  • Funnel Step: where the shopper is in their journey, Discovery, Research or Purchase, based on how the prompt is phrased rather than a keyword match

  • Alignment: how closely the prompt matches what's actually in your catalog

  • Ranking: where your products currently place for this prompt. A 0 means you're not showing up yet

  • Volume: an estimate of how much monthly search demand sits behind this prompt, or close variations of it

  • Opportunity: our read on which prompts are worth your attention first, scored and banded as High, Medium or Low. It weighs demand against how well your catalog is currently showing up. A high score means shoppers are already asking, and you have room to improve

Filtering & Taking Action

  • Search and filter: search prompt text directly, or narrow the list by Funnel step, Category, Sub-intent or Volume to zero in on quick wins.

  • Run: click the run icon on any prompt to test it live against your Shopify Catalog and see how AI agents respond.

  • Copy: copy a prompt's exact text with one click.

  • + Add to Prompt List: push the library, or just the prompts you've selected, into your Tracked Prompts for ongoing monitoring.

Did this answer your question?