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

# Topic Detail Page

> The two-column topic page — conversation evidence on the left, stats and metadata on the right, with route, attach, and promote actions in the header

The topic detail page (`/topics/:id`) shows everything tied to one topic: the conversation evidence, the participants, the linked tickets, lifecycle history, and the actions available to move the topic into work.

## Header

The top of the page shows:

* **Topic name** with optional description below
* **Status badge** — Active (green), Stale (amber), or Resolved (gray)
* **Type badge** — Bug (red), Complaint (orange), Feature Request (blue), Feedback (purple), or Discussion (gray)

### Header Actions

Three buttons sit in the top-right:

* **Route with AI** — opens the AI Route flow to suggest attaching to an existing project or creating a new one
* **Attach to existing project** — manual picker to link this topic to a tracked item
* **Promote to project** — two-click confirm to convert the topic into a tracked-item project. The first click shows **"Really promote?"**; the second click promotes and navigates to the new project with the toast: *"Promoted '{topicName}' — attached N signal(s)."*

## Left: Conversation Evidence

The main pane lists every conversation group attached to the topic. A **conversation group** is one or more messages from the same conversation that share a topic segment.

Each group shows:

* **Provisional name** — AI-generated label for the group
* **Source label** — "Slack" or "Intercom"
* **Conversation count** and **message count**
* **Expandable thread** — click to reveal the full message exchange with speaker names and timestamps

### Context Before/After

When you expand a thread, BuildBetter shows the **N earlier messages** and **N later messages** that bracket the topic segment. Click the lazy-load button to fetch more context — useful when a segment relies on what came before.

### Group Actions

Each group has a three-dot menu with two options:

* **Create new topic** — splits the group into a new topic. On success, navigates to the new topic page.
* **Move to topic...** — opens a searchable modal to relocate the group to another existing topic.

See [Manual Actions](./topic-manual-actions) for the full details.

## Right Sidebar

### Stats

A compact row showing:

* **Message count** — total messages across all groups
* **Group count** — distinct conversation groups linked to the topic
* **Activity duration** — span from first message to last

### Priority

A numeric value (1–5) with a visual scale. Topics without a priority show **—**.

### Categories

AI-assigned topic tags as rounded pills.

### People

Conversation participants with per-person message counts.

### Linked Tickets

External issue tracker links (Jira / Linear / GitHub). Click any ticket to open it in the source system.

### History

* **Created date**
* **Resolved date** — only if applicable
* **Resolution signal** — what closed it (manual archive, all conversations closed, inactivity)

## When Things Move

The detail page reflects live state. As new conversations come in or messages get added:

* New groups appear in the left pane
* Stats refresh
* Status can flip between active and stale as the lifecycle job runs

You don't need to refresh — the page updates as the data does.