PromptSpark.ai Docs
Sign in
Browse documentation
Docs Topics

Topics

Use Topics as stable analytical folders for prompt sets, not as visibility scores or keyword-volume estimates.

What you see on Topics

Topics shows one row per topic with its name, optional description, prompt count, display position, and edit or delete controls. New Topic creates a reporting folder. The prompt count is the number of current query records associated with the topic; it is not the number of completed provider answers and it does not multiply by providers.

Position controls ordering when topics are presented. A lower position appears earlier, but it does not indicate ranking, importance, search position, or AI performance. A dash means no explicit position was stored.

One primary theme per prompt

A prompt can belong to one topic. Use that relationship for the single main question your team wants to compare, such as a product line, decision stage, problem family, or strategic theme. Use Tags when one prompt needs several cross-cutting labels.

Topic names and descriptions are customer-defined configuration. PromptSpark.ai does not calculate them from answer text, and changing a topic does not change the prompt wording sent to providers. It changes how current and future report views group or filter that prompt.

How topic filtering changes metrics

{"When Topic is selected in a report, eligible executions are limited to prompts assigned to that topic. Visibility, Share of Voice, sentiment, position, source counts, and coverage are recalculated from those executions. Topic prompt count and report response count are therefore different" => "one prompt can create several provider executions, and only fully analyzed executions enter most brand metrics."}

Before comparing topics, check prompt count, enabled providers, completed response count, markets, and intent mix. A topic with two prompts is far more sensitive to a single response than a topic with fifty prompts.

Design useful topics

  • Use mutually understandable names that remain useful for several reporting cycles.
  • Keep themes broad enough to contain several related customer questions but narrow enough to lead to one owner or decision.
  • Avoid using topics as temporary campaign flags; Tags are better for overlapping or short-lived labels.
  • Review unassigned prompts and overlarge topics regularly.
  • Record major reclassification dates when topic trends are shared externally.