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

# Topics

> How Modem discovers and organizes conversation themes

**Topics** are AI-discovered conversation themes that group related messages across your data sources. They're the primary way Modem helps you understand what users are talking about.

## How Topics Are Created

As messages arrive from your connected sources, Modem analyzes them and groups related conversations into topics. When a new message fits an existing topic, it's added. When it doesn't, a new topic is created.

Within channels, Modem also identifies where one conversation ends and another begins, creating distinct discussions within topics even when multiple conversations happen in parallel.

<Info>Topics are generated automatically. You don't need to tag, label, or categorize messages yourself.</Info>

## What a Topic Contains

Each topic has an AI-generated title and summary, along with a priority level and the people involved.

### Feedback Classification

Each topic is classified by feedback type:

| Category            | What it captures                                              |
| ------------------- | ------------------------------------------------------------- |
| **Bug Report**      | Error descriptions, broken functionality, unexpected behavior |
| **Feature Request** | Suggestions, wishlist items, enhancement ideas                |
| **Complaint**       | Frustration, dissatisfaction, negative experiences            |
| **Praise**          | Positive feedback, compliments, appreciation                  |

Not every topic fits neatly into a category. Topics that don't match a clear feedback type are left unclassified.

### Summaries

Modem generates summaries to help you scan topics quickly:

* **Topic summaries.** A high-level overview of what a topic is about and its key themes.
* **Attributed summary points.** Bullet-point takeaways linked back to the specific messages and authors they came from, so you can trace any insight to its source.

## Discussions

A topic can contain multiple **discussions**: distinct conversations that share the same theme but happened at different times or in different channels.

For example, a topic about "API rate limiting" might have:

* Initial discussion about rate limit errors (January, Slack #support)
* Feature request for rate limit headers (March, Discord #suggestions)
* Bug report about incorrect 429 responses (May, GitHub Issues)

Discussions help you see the evolution of a topic over time.

## Working with Topics

### Browsing

Navigate to **Topics** in your dashboard to see all discovered topics, sorted by recent activity.

Filter by:

* **Search.** Find topics by keyword or phrase.
* **Category.** Filter by topic keywords or tags.
* **Feedback type.** Bug reports, feature requests, complaints, or praise.
* **Priority.** Very low through very high.
* **Company.** Topics where a specific company's users have participated.

### Searching

Search uses semantic matching, so you'll find related topics even if they don't contain your exact search terms.

<Tip>Searching for "authentication problems" will find topics about "login issues," "OAuth errors," and "sign-in bugs."</Tip>

### Topic Details

Click on a topic to see:

* All messages organized by discussion
* Attributed summary points linked back to source messages
* People involved and their contributions
* Source channels and platforms
* Change history and any linked Linear issues

## Automations

Topic activity can trigger [automations](/features/automations). You can create event automations that run when:

* **A new topic is created**
* **A topic reaches high priority**

Use these when you want Modem to react immediately, for example by posting an alert to Slack, creating follow-up work, or sending a summary to the right team.

## Related

<CardGroup cols={2}>
  <Card title="Companies & People" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/users.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=32a2de5620a3659206db1c3d1aff5a06" href="/guides/people" width="24" height="24" data-path="icons/users.svg">
    Unified profiles for users and organizations.
  </Card>

  <Card title="The Modem Agent" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/bot.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=2496f9106cb54fa9f4e27ad1f8f3a171" href="/features/agent" width="22" height="22" data-path="icons/bot.svg">
    Ask questions and take action using natural language.
  </Card>
</CardGroup>
