> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surfacd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Topics & Tags

> Topics group your prompts into categories for structured analysis. Tags add flexible labels for cross-cutting filtering and comparison.

Surfacd provides two ways to organise your prompts: **Topics** for primary categories and **Tags** for flexible labelling.

## Topics

### What Are Topics?

Topics are project-level categories that group your prompts by business area. Each prompt belongs to at most one topic, giving your prompt library a clean, structured hierarchy.

Examples of topics:

* Email Marketing, CRM, Sales Engagement, Marketing Automation
* Enterprise Solutions, SMB Products, Partner Integrations
* Data Privacy, Cloud Security, Compliance

### How Topics Are Created

**During onboarding:** After creating your project, Surfacd analyses your brand and generates suggested topics automatically. You can edit names and descriptions, add or remove topics, and set a target audience before prompts are generated for each topic.

**From the Prompts page:** When adding prompts manually or via [Suggest Prompts](/docs/suggested-prompts), use the Topic field to pick an existing topic or create a new one.

**Via bulk actions:** Select prompts and use **Change Topic** to assign or reassign topics in bulk.

### Using Topics in Analysis

* **Filter any report** by topic to focus on a specific business area
* **Matrix Analysis:** Topic is a dimension — compare Brands x Topics, Topics x Countries, and more
* **Grouped view:** Toggle the prompts table to display prompts grouped by topic in an accordion layout
* **Uncategorized:** Prompts without a topic appear under "Uncategorized" in filters and grouped views

## Tags

### What Are Tags?

Tags are flexible labels you can apply to any prompt. Unlike topics (one per prompt), a prompt can have multiple tags, making them ideal for cross-cutting dimensions like funnel stage, intent type, or priority.

### Creating Tags

Tags are created as you add them to prompts — just type a new name in the Tags field.

### Tagging Strategies

Choose an approach that fits your needs:

* **By Funnel Stage:** Awareness, Consideration, Decision
* **By Intent Type:** Best Of, Comparison, How To, Recommendations
* **By Priority:** Core, Growth, Competitive, Exploratory
* **Combined:** Use multiple tag dimensions for richer analysis

### Using Tags in Analysis

* **Filter any view** by tag to focus on specific groupings
* **Matrix Analysis:** Compare Brands x Tags to see which labels each brand dominates
* **Identify gaps:** Find tags where you underperform vs competitors

## Topics vs Tags

|                  | Topics                                           | Tags                                          |
| ---------------- | ------------------------------------------------ | --------------------------------------------- |
| **Purpose**      | Primary prompt categories by business area       | Flexible labels for cross-cutting analysis    |
| **Relationship** | One topic per prompt                             | Multiple tags per prompt                      |
| **Created**      | AI-generated during onboarding, editable anytime | Manually created as needed                    |
| **Best for**     | Structuring your prompt library                  | Adding dimensions like funnel stage or intent |
| **Example**      | "Enterprise CRM", "Email Marketing"              | "Awareness", "Comparison", "High Priority"    |

## Best Practices

* Use **Topics** for your main organisational structure — group prompts by business area or product category
* Use **Tags** for cross-cutting dimensions that span multiple topics
* Every prompt should have a topic; tags are optional enrichment
* Start with 5–10 tags — add more as needed
* Be consistent with naming for both topics and tags
* Review monthly: merge unused tags, add new topics for emerging business areas
