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

# GEO Matrix

> A heatmap-style matrix that maps your brand's AI visibility across topics (or tags, funnel stages, prompts) and AI providers in a single view.

The **GEO Matrix** is Qwairy's signature diagnostic tool. It gives you a topic × provider heatmap — so you can instantly spot where your brand is strong, where it's weak, and which combinations need attention.

Navigate to **Cockpit > GEO Matrix** in the left navigation menu.

## How the Matrix Works

Each **row** represents a grouping (topic, tag, funnel stage, or individual prompt), and each **column** represents an AI provider (ChatGPT, Claude, Gemini, Perplexity, Copilot, etc.).

Each **cell** displays your brand's **ranking** among your competitors for that combination. The ranking is shown as `#rank/total` (e.g., `#2/8` means you rank 2nd out of 8 competitors tracked). Below the ranking, the cell also shows the **average value** of the selected metric across that provider column.

### Ranking Colors

Cell colors are based on your ranking position relative to competitors:

| Color  | Position     | Meaning                     |
| ------ | ------------ | --------------------------- |
| Green  | #1           | You lead the competition    |
| Blue   | Top third    | Strong competitive position |
| Yellow | Middle third | Average — room to improve   |
| Orange | Bottom third | Weak — needs attention      |

A **Coverage** column on the right shows the percentage of providers where your brand is mentioned or cited at least once.

## Metric Selector

Use the **metric dropdown** above the matrix to choose which metric the rankings and averages are based on:

| Metric             | What it measures                                                                  |
| ------------------ | --------------------------------------------------------------------------------- |
| **Score**          | Overall visibility score (0–100), combining all sub-metrics                       |
| **Mention Rate**   | Out of all AI responses that mention any brand, the percentage that mention yours |
| **Share of Voice** | Out of all brand mentions in AI responses, the percentage that are yours          |
| **Citation Rate**  | Out of all AI responses that cite any source, the percentage that cite yours      |
| **Sentiment**      | Average sentiment of how your brand is described (0–100)                          |

Switching the metric updates the entire matrix — rankings, colors, and averages all reflect the selected metric.

<Tip>
  Use **Share of Voice** to understand your competitive position, and **Citation Rate** to see where AI providers reference your content as a source.
</Tip>

## Granularity Modes

Use the tabs above the matrix to switch between four views:

| Mode        | Rows show          | Best for                                      |
| ----------- | ------------------ | --------------------------------------------- |
| **Topics**  | Your brand topics  | High-level strategic view                     |
| **Tags**    | Custom tags        | Segment-level analysis (campaigns, audiences) |
| **Funnel**  | TOFU / MOFU / BOFU | Sales funnel visibility gaps                  |
| **Prompts** | Individual prompts | Drill-down into specific questions            |

<Info>
  If you have exactly one topic or tag selected in the global filters, the corresponding tab is hidden automatically — there's no need for a single-row breakdown.
</Info>

## Sorting

Click any column header to sort the matrix:

* **Name** — alphabetical
* **Coverage** — by coverage percentage
* **Provider column** — by ranking on that specific provider

Click again to toggle ascending/descending.

## Cell Detail Panel

Click any cell to open a detail panel on the right. It shows:

### Sub-Metric Rankings

Each sub-metric displays your brand's **ranking** among competitors (`#rank/total`), color-coded by ranking position (same color scheme as the matrix cells). This lets you quickly identify which specific dimensions are dragging your overall position down.

| Sub-metric         | What it measures                                                               |
| ------------------ | ------------------------------------------------------------------------------ |
| **Mention Rate**   | Out of all responses that mention any brand, the percentage that mention yours |
| **Share of Voice** | Out of all brand mentions, the percentage that are yours                       |
| **Citation Rate**  | Out of all responses citing any source, the percentage that cite yours         |
| **Sentiment**      | Tone of how your brand is described (0–100)                                    |

### Top 5 Competitors

The competitors most frequently mentioned for this topic × provider combination, with their mention count and average position. Only your direct competitors are shown.

### Top 5 Sources

The domains most frequently cited as sources by the AI provider for this topic. This list is filtered to show only sources owned by your brand or your direct competitors — giving you a focused view of the competitive source landscape.

## Filters

The GEO Matrix respects global filters:

| Filter        | Effect                                 |
| ------------- | -------------------------------------- |
| **Providers** | Show/hide provider columns             |
| **Topics**    | Filter which rows appear (Topics mode) |
| **Tags**      | Filter which rows appear (Tags mode)   |
| **Period**    | Change the time range for scores       |

## Export

Click the **Export PNG** button (top-right) to download the matrix as an image — useful for reports and presentations.

You can also create a **Shared Link** of type "GEO Matrix" from the share menu to give external stakeholders a read-only snapshot.

## Related use cases

* [For which topics does my brand appear in AI answers?](/use-cases/visibility/for-which-topics-does-my-brand-appear)
* [Which topic + provider combination is my biggest competitive weakness?](/use-cases/reporting/biggest-topic-provider-weakness)
* [Why does my brand score differently across Perplexity, Gemini, and Claude?](/use-cases/providers/different-scores-across-providers)