Skip to main content
Queries are the foundation of your monitoring in MentionLab. Each query is a question sent to AI platforms to observe how they respond. Tags help you organize queries into meaningful groups for analysis.

Managing queries

Creating queries

Navigate to Project Settings → Queries to manage your query list. You can add queries in several ways:
  • Manual entry — Type individual questions that represent how your customers search for products in your category
  • AI suggestions — During project setup, MentionLab analyzes your website and proposes relevant queries
  • Import from file — Upload a CSV or Excel file with pre-written queries
Write queries from your customer’s perspective. Instead of “Is Acme good?”, try “What is the best project management tool for remote teams?” — this is how real users ask AI platforms.

Query properties

Each query has the following properties:
PropertyDescription
TextThe question or prompt sent to AI models
LanguageThe language the query is written in
CountryThe country context for the query
TagsOne or more tags for categorization

Bulk operations

From the queries settings page, you can:
  • Add or remove tags from multiple queries at once
  • Launch an analysis for your queries
  • Export queries to CSV for backup or sharing
  • Delete queries in bulk
Deleting a query also removes its historical results.

Understanding query results

On the Queries page, each query displays key metrics:
MetricDescription
Mention Rate %Percentage of AI responses that mentioned your brand for this query
Average PositionWhere your brand ranks in responses for this query (lower is better)
Sentiment ScoreAverage sentiment score across responses (0–100)
Source Rate %Percentage of responses that included source citations
Click any query to open its detail view, which shows:
  • Metric cards (total responses, mention rate, avg sentiment, source rate, shopping rate)
  • Top sources and sources by model
  • Response history with full AI response text, entity badges, and source links
  • Entities mentioned table

Managing tags

Creating tags

Navigate to Project Settings → Tags to create and manage tags. Each tag has:
  • Name — A descriptive label (e.g., Pricing, Features, Use Cases)
  • Color — A visual identifier for the tag

Using tags for analysis

Tags unlock powerful segmentation across MentionLab:
  • Dashboard — The tags summary and tag-brand matrix show performance per tag group
  • Tags analysis page — Dedicated view of share of voice, top brands, and top sources per tag
  • Filters — Filter any analysis page to show only queries with specific tags
Create tags that align with your business objectives. For example: product categories, customer personas, purchase intent stages, or geographic markets.

Tag filtering modes

When filtering by tags, you can choose between two modes:
  • OR mode — Shows results for queries matching any of the selected tags
  • AND mode — Shows results for queries matching all of the selected tags

Response tags

Response tags are different from query tags. While query tags categorize the questions you ask, response tags categorize the AI-generated answers you receive. You can manage response tags from Project Settings → Response Tags and apply them to individual responses from Project Settings → Response Tagging. This is useful for:
  • Categorizing response types (e.g., “recommends us”, “mentions competitor only”)
  • Tracking specific response patterns over time
Response tags can also be used as filters on your analysis pages, just like query tags.