Skip to main content

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.

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, 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

TopicsTags
PurposePrimary prompt categories by business areaFlexible labels for cross-cutting analysis
RelationshipOne topic per promptMultiple tags per prompt
CreatedAI-generated during onboarding, editable anytimeManually created as needed
Best forStructuring your prompt libraryAdding 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