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

# Key concepts: Categories, topics & sentiment

> Understand the building blocks of analysis in Caplena before you start.

Caplena analyzes open-ended feedback by organizing it into categories, topics, and (optionally) sentiment. Getting familiar with these three concepts will make everything else click faster.

### Category

A **category** is a high-level theme that groups related topics together, for example `Customer Service`, `Product Quality`, or `Pricing`.

<Frame>
  <img alt="Categories" lightAlt="Categories" darkAlt="Categories" src="https://mintcdn.com/caplena-32172960/srogR5j8CKBen39K/images/Screenshot-2026-05-19-at-20.32.08.png?fit=max&auto=format&n=srogR5j8CKBen39K&q=85&s=93ff4d5c0529fadfc2d68d1263f14aab" width="1632" height="216" data-path="images/Screenshot-2026-05-19-at-20.32.08.png" />
</Frame>

<Note>
  Categories are taken into account by the AI when assigning topics.
</Note>

### Topic

A **topic** is a specific idea or theme within a categorym what someone is actually talking about in their response. Topics are also referred to as codes, themes, or labels.

Examples within a Customer Service category:

* `Support Responsiveness`
* `Refund Process`
* `Property Communication`

#### Topic label

The **topic label** is the short name you give a topic. It appears on topic chips throughout Caplena and is what the AI uses to recognize and assign the topic.

<Note>
  The label directly affects AI accuracy, keep it clear and specific.
</Note>

#### Topic description

A longer explanation of what the topic covers and when it should apply. Descriptions give the AI more context and are especially important for topics that might otherwise overlap.

<img alt="Topic description" lightAlt="Topic description" darkAlt="Topic description" className="mx-auto" src="https://mintcdn.com/caplena-32172960/srogR5j8CKBen39K/images/Screenshot-2026-05-19-at-20.34.35.png?fit=max&auto=format&n=srogR5j8CKBen39K&q=85&s=4d365e96d6f211bdc6a5f4c1e8640d2b" width="856" height="1148" data-path="images/Screenshot-2026-05-19-at-20.34.35.png" />

<Note>
  Topic descriptions are used by the AI when assigning topics, the more precise, the better the results.
</Note>

#### Code

A **code** is a unique numerical ID assigned to each topic. Caplena assigns one automatically, but you can set it manually if you need to match an existing coding scheme.

<img src="https://mintcdn.com/caplena-32172960/srogR5j8CKBen39K/images/Screenshot-2026-05-19-at-20.36.25.png?fit=max&auto=format&n=srogR5j8CKBen39K&q=85&s=53fe35f9f9c833b4a845535f54430a25" alt="Screenshot 2026 05 19 At 20 36 25" title="Screenshot 2026 05 19 At 20 36 25" className="mx-auto" style={{ width:"51%" }} width="872" height="1356" data-path="images/Screenshot-2026-05-19-at-20.36.25.png" />

### Sentiment

**Sentiment** adds emotional context to topics, classifying each response as **positive**, **neutral**, or **negative**. Instead of just knowing what someone talked about, you also know how they felt about it.

<img alt="Sentiment" lightAlt="Sentiment" darkAlt="Sentiment" className="mx-auto" src="https://mintcdn.com/caplena-32172960/srogR5j8CKBen39K/images/Screenshot-2026-05-19-at-20.41.26.png?fit=max&auto=format&n=srogR5j8CKBen39K&q=85&s=c0dc00e5bf5d60864140e9d59440d326" width="872" height="1366" data-path="images/Screenshot-2026-05-19-at-20.41.26.png" />

For example:

* `Support / Helpfulness – Positive` → "The team was incredibly helpful"
* `Support / Helpfulness – Negative` → "No one responded to my request"

You only need to create one topic (e.g. `Support`), the AI assigns the sentiment automatically.

**Sentiment is optional.** Turn it on for opinion-based data like NPS or CSAT. Skip it for factual data like feature requests or open suggestions.

#### Disabling sentiment

<Warning>
  If you disable sentiment on a topic, all sentiment labels are permanently removed. This cannot be undone.
</Warning>

<iframe src="https://www.loom.com/embed/61a1db99a0fa48efb34315745c9546d7" title="Loom video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
