Discovery Queries Dashboard
The Discovery Queries dashboard manages the prompts that are run in Spyglasses AI Visibility Reports. These queries represent how your potential customers search for solutions in AI assistants.
What You'll Learn
In this guide, you'll learn:
- How discovery queries work
- How queries are generated
- How to edit and customize queries
- How to manage your query library
How Discovery Queries Work
When you run an AI Visibility Report, Spyglasses takes your discovery queries and runs them across multiple AI platforms (ChatGPT, Claude, Gemini, Perplexity, Copilot). The report then analyzes which brands get mentioned, cited, and recommended.
If you run a report and there are existing queries here, we use them. If not, we generate five queries by default based on your brand snapshot.
Query Generation
Discovery queries are generated based on the Category Entry Point methodology—understanding how buyers research solutions before they know specific brands.
What Informs Query Generation
Queries are constructed using data from your brand snapshot:
- Category: What type of product/service you offer
- ICP (Ideal Customer Profile): Who your target customers are
- Features: What capabilities you provide
- Problems Solved: What challenges you address
Query Types We Generate
Each query type represents a different buyer intent pattern:
| Query Type | Description | Example |
|---|---|---|
| category_best | Best-in-class searches | "What are the best CRM solutions for small businesses?" |
| use_case_solution | Problem-first searches | "What software helps with customer data management?" |
| budget_constrained | Price-sensitive searches | "Affordable project management tools for startups" |
| solution_comparison | Comparison searches | "Compare different email marketing platforms" |
| segment_focused | Niche audience searches | "Best analytics tools for healthcare companies" |
| local_services | Location-specific searches | "Best marketing agencies in Austin, Texas" |
| local_comparison | Local provider comparisons | "Compare web designers in Chicago" |
| local_reviews | Review-focused local searches | "Top rated accountants near Miami" |
Why These Query Types
These represent high-intent queries at the research stage. Buyers asking these questions are actively evaluating solutions and are most likely to be influenced by AI recommendations.
Viewing Your Queries
The main table shows all discovery queries with:
| Column | Description |
|---|---|
| Query | The prompt text |
| Type | Query type (category_best, etc.) |
| Category | Product/service category |
| Segment | Target audience |
| Location | Location context (if any) |
| Status | Active or inactive |
| Actions | Edit, deactivate, delete |
Editing Queries
Click on a query or the edit icon to open the edit panel. You can modify:
Query Text
The actual prompt that will be run. This directly influences what AI platforms are asked. Make sure it reflects how real customers would search.
Location
For location-specific queries, set the geographic context. Location is embedded in the prompt and affects AI responses.
Metadata Fields
You can also set or update:
- Category: Product/service category
- Target Segment: Customer type (SMB, Enterprise, etc.)
- Use Case: Specific problem being solved
- Budget Range: Price context
Important: Only the query text and location actually influence the AI prompt. The other fields (category, segment, use case, budget) are for your own classification and analysis. They don't change how AI responds.
Activating and Deactivating Queries
Deactivating
If you want to stop using a query but keep the historical data:
- Click edit on the query
- Toggle "Active" off or click "Deactivate"
- Save
Deactivated queries:
- Won't be used in future reports
- Retain all historical data
- Can be reactivated later
Reactivating
To bring back a deactivated query:
- Show inactive queries (filter)
- Click edit
- Toggle "Active" on
- Save
Deleting Queries
To permanently remove a query:
- Click the delete icon
- Confirm deletion
Warning: Deleting a query removes its data from this dashboard. However, it will still appear in historical reports where it was used.
Regenerating Queries
If you want to start fresh with new queries based on your latest brand snapshot:
- Click "Regenerate Queries" or similar button
- Confirm the action
- Five new queries are generated based on current snapshot data
This is useful if:
- Your brand positioning has changed
- You want to test different query angles
- Initial queries weren't representative
Best Practices
Match Real Customer Behavior
The default queries represent our best understanding of high-intent user queries at the research stage. But you know your brand best.
If these queries aren't reflective of how you expect your target customer to search in AI:
- Edit them to match real customer language
- Add queries based on sales conversations
- Remove queries that don't match your audience
Need Help?
If you need help coming up with ideas, reach out to support@spyglasses.io. We're happy to help brainstorm and offer suggestions at no charge.
Quality Over Quantity
5-10 well-crafted queries provide more value than 50 mediocre ones. Focus on:
- Queries your prospects actually ask
- High-intent buying signals
- Topics where you can win
Review After Reports
After each AI Visibility Report, review which queries performed well and which didn't. Refine your library based on results.
Include Competitor Comparisons
By default, Spyglasses' queries focus on the category as a whole, but if you want to see how you are positioned against a specific competitor, you can add queries like:
- "Alternatives to [Competitor]"
- "[Your Category] like [Competitor] but cheaper"
Query Limits
With any Spyglasses plan you can manage up to ten queries per property.
Related
- AI Visibility Reports - Run reports using your queries
- AI Visibility Rankings - See grounding search results
- Historical Metrics - Track results over time
- Settings - Configure location for your property