> ## 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.

# Topic Breakdown / Heatmap

> Compare topics across segments, brands, or regions to identify trends and significant differences.

The **Topic Breakdown / Heatmap** is a powerful visualization tool that helps you compare **brands, segments, or regions** across key topics. With **color intensity** and **significance indicators**, it makes spotting trends in large datasets simple and effective.

## Key Components

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/SXA_UUcXANKZOy2K/images/Screenshot-2026-05-25-at-10.56.33.png?fit=max&auto=format&n=SXA_UUcXANKZOy2K&q=85&s=ad4e5de210837a72d405fa9b17824b1f" alt="Topic Breakdown / Heatmap overview" width="3128" height="1156" data-path="images/Screenshot-2026-05-25-at-10.56.33.png" />
</Frame>

1. **Rows** — Represent topics (e.g., *Customer Service*, *Pricing*)
2. **Columns** — Represent segments, brands, or regions (e.g., *Brand One*, *Germany*, *USA*)
3. **Cell values** — Show the **% of responses** that mention a specific topic
4. **Color intensity** — Light blue = lower mention %, dark blue = higher mention %

## Statistically Significant Differences

One of the most valuable features of the Heatmap is its ability to highlight **statistically significant differences** using **yellow boxes** — these flag where a topic is mentioned significantly more or less in one segment versus others.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/SXA_UUcXANKZOy2K/images/Screenshot-2026-05-25-at-10.57.28.png?fit=max&auto=format&n=SXA_UUcXANKZOy2K&q=85&s=11d41fa5f17d0d050e013be56411adfb" alt="Statistically significant differences highlighted in yellow" width="3120" height="1454" data-path="images/Screenshot-2026-05-25-at-10.57.28.png" />
</Frame>

For example, if *Customer Service* is mentioned by 39.6% of respondents in Brazil but 80.4% in the USA, that difference is flagged as significant because it's unlikely to be due to chance.

For clearer side-by-side comparison, you can **switch to a bar chart view** — each bar shows topic frequency per segment, and a **★ star** indicates a statistically significant difference (equivalent to the yellow boxes in the heatmap).

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/SXA_UUcXANKZOy2K/images/Screenshot-2026-05-25-at-10.59.30.png?fit=max&auto=format&n=SXA_UUcXANKZOy2K&q=85&s=6a744c046160c4294b7873c900e1844a" alt="Bar chart view with significance stars" width="3116" height="1640" data-path="images/Screenshot-2026-05-25-at-10.59.30.png" />
</Frame>

## Add Sentiment to Your Heatmap

Toggle **sentiment filters** to explore positive, neutral, or negative sentiment per topic and segment.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/SXA_UUcXANKZOy2K/images/Screenshot-2026-05-25-at-11.01.59.png?fit=max&auto=format&n=SXA_UUcXANKZOy2K&q=85&s=8fe722c5e21610dfd7e573b779bed92c" alt="Sentiment filters on the heatmap" width="3134" height="1238" data-path="images/Screenshot-2026-05-25-at-11.01.59.png" />
</Frame>

* **Spot strengths** — Topics with high positive sentiment
* **Identify weaknesses** — Topics with high negative sentiment
* **Compare across regions** — See how brand perception shifts by location

<Note>
  **Example:** *Customer Service* in **Germany** is mentioned in 12% of responses, mostly with negative sentiment — suggesting potential service issues in that region.
</Note>

## Video Walkthrough

<iframe src="https://www.youtube.com/embed/X6foyU3NC18" title="YouTube 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 />
