What are Topics?
A topic is a category that groups related prompts together: Topic: “Discovery”- “What is the best data validation library for Python?”
- “Top schema validation tools”
- “Recommended API validation solutions”
- “Migrate from Pydantic v1 to v2”
- “Alternatives to Marshmallow for Python”
- “Replacing Cerberus with a modern validator”
Starting Topics
The prompts you choose in the setup wizard are saved under five starting topics: Capability, Developer Experience, Setup & First Run, Integrations & Ecosystem, and Performance & Reliability. Suggest Prompts on the Prompts tab offers five more: Pricing & Licensing, Security & Compliance, Guides & Patterns, ROI & Case Studies, and Support & Migration, as well as any topic you created. You can rename or delete any topic.Why Use Topics?
Thematic Analysis
See presence by theme:- Which themes show strong presence?
- Where are thematic gaps in your AI visibility?
- Which themes have the most competitive pressure?
Strategic Planning
Understand which areas of the buyer journey need attention:- Strong presence on capability prompts but weak presence on setup prompts suggests your content explains “what” but not “how”
- Strong presence on troubleshooting prompts but weak presence on category prompts means buyers find you when they have problems but not when they are exploring
Creating and Managing Topics
Creating a Topic
Open Insights › Visibility, then the Prompts tab. Topics are listed in the topic sidebar beside your prompts.- Select Add Topic
- Enter a topic name
- Save
Assigning Prompts to Topics
Every prompt belongs to a topic. When you add or edit a prompt, select its topic, then save. To move many prompts at once, delete their topic and choose Move to Another Topic.Editing Topics
Select a topic in the topic sidebar to filter the prompt list to that topic. To change its name, open the topic’s menu and select Rename.Deleting Topics
Open the topic’s menu and select Delete. If the topic still has prompts, choose what happens to them:- Move to Another Topic keeps the prompts running under the topic you select, then deletes the topic
- Delete All Prompts removes the topic and its prompts. Future runs stop and past results keep their recorded values. You can restore the topic and its prompts from the Deleted view; they come back disabled.
prompts.write scope can create, rename, switch and delete topics through the API and MCP. Deleting a topic there deletes its prompts; move any you want to keep to another topic first.
Branded and Mixed Topics
A prompt that names your brand, or one of its brand terms, is marked Names followed by your brand. A topic where every prompt does is marked Branded, and the dashboard leaves it out of headline visibility by default. Brand terms you have retired still count. A topic with some prompts that name your brand and some that do not is marked Mixed, and still counts in the headline. To separate them:- Select the topic in the topic sidebar
- Select Split topic
- Enter a name for the branded topic. An existing topic can be reused only if it is empty or every prompt in it names your brand
- Select Split topic
Topic Coverage
The topic sidebar shows each topic’s coverage, for example40% presence · 4 of 10 answered prompts: the share of the topic’s answered prompts where at least one answer cites you. It counts prompts, not answers, so it isn’t the same as Presence Rate. For Presence Rate and the other metrics for one topic, select the topic in the Dashboard’s Topics filter.
Topic Organization Strategies
By Buyer Journey Stage
Group prompts by where the buyer is:- Discovery - “Best [category] tools”, “What is [category]?”
- Evaluation - “[Product] vs [Competitor]”, “Compare [options]”
- Integration - “How to set up [product]”, “[Product] quickstart”
- Migration - “Migrate from [competitor]”, “[Competitor] alternatives”
- Troubleshooting - “Fix [error] in [product]”, “[Product] performance issues”
By Feature Area
Organize by product capabilities:- Authentication - Auth-related queries
- Data Processing - Data handling queries
- API Integration - API connection queries
By Audience
Organize by target user type:- Beginners - Entry-level queries
- Enterprise - Business and scale-focused queries
- Specific Language - Language or framework-specific queries
Best Practices
Balanced Topic Sizes
Aim for 5-15 prompts per topic. Topics that are too small may not provide meaningful aggregate data. Topics that are too large may mix unrelated themes.Clear, Descriptive Names
Use names that clearly indicate the theme:- “Getting Started Guides” - Clear
- “Topic 1” - Not helpful
Topics and Analytics
Filtered Dashboard Views
Use topics to filter the Dashboard tab of Insights › Visibility. Select a topic to scope Presence Rate, Average Position, the trend and the Market comparison to that topic’s prompts. Sentiment isn’t available with a topic filter, and Positioning appears only with no topic filter.Cross-Topic Comparison
Compare topic coverage in the topic sidebar, or switch the Dashboard’s topic filter, to see which areas of the buyer journey are strongest and weakest for your brand.Next Steps
- Prompts - Manage individual prompts
- Tracked URLs - Configure the URLs DevTune attributes to brands
- Understanding Metrics - How topic data feeds into metrics
- Visibility Dashboard - View topic-filtered results