Skip to main content
Raw prompt-level data is only as useful as the structure behind it. Topics and tags are the two organizational layers that turn a flat list of prompts into segmented, actionable metrics.

Topics

A topic is a named group of prompts that belong to a common theme: a product line, a use case, a target market, a geography. Topics are the primary slicing dimension for every metric in the dashboard: visibility, position, sentiment, and Share of Voice can all be filtered or broken down by topic. Why this matters: a blended visibility score across 80 prompts tells you little. Visibility by topic shows you that you’re strong in “email automation” but invisible in “CRM for agencies.” That’s a gap you can actually act on. Each topic can optionally be scoped to a specific brand, country, and language. Use this when a product line applies to one market but not another, or when you want separate tracking for different regions.

Creating and managing topics

From the Topics page in your project’s configuration area, click New topic and give it a name. You can also assign it an optional brand, country, and language scope at creation time. The Topics page shows a Suggested topics panel when Mavel has identified themes from your captured answers that you don’t yet have as topics. Accept or reject each suggestion inline.

Assigning prompts to topics

On the Prompts page, you can assign a topic to any prompt from the prompt’s menu. The topic sidebar on the left of the Prompts list lets you filter to a single topic, and the top filter bar supports multi-topic filtering via the Topics chip.
Assign topics before you start reading metrics. The onboarding wizard seeds an initial set of topics from your profile: review them and adjust before your first crawl runs, rather than after a week of unorganized data.

Tags

Tags are freeform labels that cut across topic boundaries. Use them for dimensions that don’t map neatly onto a single topic:
  • Funnel stage (awareness, consideration, decision)
  • Campaign (Q3 push, product launch)
  • Priority (high, low)
  • Any other dimension your team cares about
Tags are available as a filter in the top filter bar across every analytics view: the same bar where you filter by topic, brand, and surface.

System tags

Every new project is seeded with four system tags automatically: System tags cannot be deleted, but they behave like any other tag for filtering purposes. After a prompt is created, Mavel’s intent classifier runs automatically and applies the informational or transactional tag for you. The branded and non-branded tags are seeded with the project but are yours to assign manually where you want them as explicit filters.

Creating custom tags

From the Tags page, create a tag by giving it a name and a color. Tags are then available to assign to any prompt from the Prompts page. You can edit the name and color of any custom tag at any time. Custom tags (but not system tags) can be deleted when they’re no longer needed.

How topics and tags interact

Topics and tags serve different purposes and work together rather than replacing each other:
  • Topics are exclusive: each prompt belongs to at most one topic. They’re the structural backbone of your prompt set.
  • Tags are additive: a prompt can have multiple tags. They’re the ad-hoc labels you apply when you need a view that crosses topic lines.
In practice: a prompt like “best CRM for real estate agents” might sit in a “CRM” topic and also carry the tags “informational” (applied automatically) and “Q3 campaign” (applied by you). Filtering by topic narrows to CRM prompts; filtering by tag narrows to Q3 campaign prompts regardless of topic.