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

# Category and brand narrative

> The perception points AI engines use about your category and each brand, and the Brand perception settings that feed them

The two narrative pages show what AI answers say about brands, not only whether they name them.
**Brand intelligence → Category narrative** reads every answer of the project.
**Brand intelligence → Brand narrative** reads the answers about one brand.

> [!NOTE]
>
> Both pages stay empty until the project's theme analysis is on. It is off for a new project. Turn it
> on in [Brand perception settings](#brand-perception-settings).

## Key terms

| Term | Meaning |
| - | - |
| **Perception point** | A short quality or topic that AI answers link to a brand, such as "long-lasting" or "fast delivery" |
| **Theme** | A group of related perception points, such as "Delivery". Points with no theme are in **Ungrouped** |
| **Appearances** | How many times AI answers use a point, or the points of a theme |
| **Share of mentions** | The appearances of a point, divided by the appearances of all points |
| **Leader** | The brand with the most appearances on a point or a theme |
| **Tone** | **Positive** from a net sentiment of +0.20, **Negative** under -0.20, **Neutral** between ([Sentiment](https://docs.mentionlab.io/guides/sentiment-analysis.md)) |

A brand's share on a point is its part of the appearances that name a brand. The **Brand map**, the
**Compare matrix** and the **Head-to-head** use this share.

## Category narrative

The tone switch (**All**, **Positive**, **Neutral**, **Negative**) under the top strip narrows every card.

| Card | What it shows |
| - | - |
| Top strip | **Perception themes**, **Perception points**, **Top positive point**, **Top negative point** |
| **Themes overall all brands** | A map of the 50 most mentioned points. Size is how often engines use a point, color is its theme. Points that come up in the same answers sit close together |
| **Perception points ranking all brands** | One row per theme, the most appearances first: **Perception theme**, **Appearances** (split by tone), **Leader**, **Share of mentions**. Click a theme to list its points |
| **Brand map** | Pick a point for **X axis** and **Y axis**. Each bubble is a brand, placed by its share on each point and sized by its mention rate. It shows up to 10 brands |
| **Attribute linking all brands** | A ring of the 50 most mentioned points. Click a point to see how often it comes up with each other point. A thicker link means more often |
| **Compare matrix** | One row per point, one column per brand. Each cell is the brand's share on that point. A brighter cell means the brand owns that point |

In the **Compare matrix**, pick 1 to 8 brands in **Brands**. It starts with 5 brands, your brand
first. Use **Search perception points…** to find a point, and click a column header to sort.

## Brand narrative

Pick the brand at the top of the page. The line under it gives the industry and the date range. The
same tone switch narrows every card.

| Card | What it shows |
| - | - |
| **What AI praises** | The brand's positive points, most frequent first, 10 a page, with the share of mentions |
| **What AI criticizes** | The brand's negative points, in the same way |
| **Themes for** your brand | The map of the brand's 50 most mentioned points |
| **Head-to-head** | Your brand against a rival on the points you pick |
| **Attribute linking** | The ring of the brand's points and their links |

In **Head-to-head**, each bar is the brand's share on the point. The rival is the top other brand of
the brand list until you pick another. The card starts on the 6 points that the category mentions most. Pick up
to 12 in **Perception points**. The badge counts the points where your brand leads, such as
"You lead 4 of 6".

## A perception point's sheet

Click a point on any card to open its sheet. The sheet covers all brands on the Category narrative
page, and one brand on the Brand narrative page.

| Part | What it shows |
| - | - |
| Header | The point, its tone, its appearances and share. The leader (category) or the net sentiment (brand) |
| **Share of mentions**, **Trends** | The share, and its change in points against the comparison period |
| **Share of mentions over time** | The share per day, week or month |
| **Sentiment of mentions** | The **Positive**, **Neutral** and **Negative** split, with counts |
| **Brands on this perception point** | Category: each brand's share. Brand page: **Engines on this perception point** |
| **Top sources for this perception point** | The domains cited in these answers, by citation rate. The brand page adds **URLs** |
| **Example mentions** | Quotes from answers. **View in AI response** shows the full answer |

**Create a response tag** opens the Response tagging settings ([Prompts and tags](https://docs.mentionlab.io/guides/queries-and-tags.md)).

## Brand perception settings

Go to **Settings → Project → Brand perception**. Its theme analysis feeds both narrative pages.

| Setting | What it does |
| - | - |
| **Theme language** | The language of the themes: **Auto (each answer's language)**, **English** (the default), **French**, **Dutch**, **German**, **Spanish**, **Italian** or **Portuguese** |
| **Theme analysis** | The switch. When it is on, each finished run goes into themes about a minute after it ends. It is off for a new project |
| **Status** | Shows while the switch is on: **Up to date**, **Queued**, **Analysing** or **Interrupted** |
| **Analyse finished runs now** | **Run now** sends the finished runs to the analysis at once, not at the next pass |

Pick the language before you turn the analysis on. While it is on, the language is locked: turn the
switch off to change it. The analysis also reads the runs that finished before you turned it on,
oldest first. An **Interrupted** pass tries again by itself.

To change these settings, you need the **Admin** or **Editor** role in the organization, or the
**Manager** or **Editor** role in the project. Other members can see the page, but not change it.
See [Organization and billing](https://docs.mentionlab.io/guides/organization-and-billing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.