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

# Competitive Position dashboard

> Read the built-in Competitive Position dashboard - CPI, competitor moves, win/loss, and the category heatmap - to see where competitors are pricing against you.

**Competitive Position** is one of the dashboards Retailgrid ships out of the box (see [Dashboards overview](/dashboards/overview)). It answers one question: **where are competitors pricing against you, and where should you react first?** Every tile reads live from your [datasets](/data-requirements/datasets) and follows the dashboard's global filters (Period, Store, Country, Zone, Category, Brand, Competitor).

This page explains each tile and how to read it. For the underlying metric definitions, see the [Metrics glossary](/reference/metrics).

## KPI row - your overall price position

The tiles across the top summarise price position at a glance, each with a prior-period comparison:

* **CPI** - your competitive price index against the market, in three reads: **CPI (Min)** vs the cheapest competitor, **CPI (Mode)** vs the most common market price, and **CPI (Weighted)** weighted by sales value so the SKUs you actually sell count most. 100 = parity, under 100 = you're cheaper, over 100 = you're more expensive.
* **Gap to cheapest competitor** - how far your price sits above or below the lowest competitor, in money and percent.
* **SKUs above / below market** - how much of your assortment is priced over vs under the market reference right now.

## SKU Position Distribution

A histogram of your SKUs bucketed by CPI, so you see the **shape** of your price position, not just the average. Bands split cleanly at parity (100): the mass to the left is where you're cheaper than the market, the mass to the right is where you're more expensive. Use it to spot a long tail of over-priced SKUs that a single average would hide.

## Competitor Price Moves

A count of distinct competitor price changes in the selected period, with a prior-period comparison. This is your "how active is the market right now?" read - a spike means competitors are repricing and your position is drifting even if your own prices haven't changed. Widen the Period filter for a trend, narrow it to catch a fresh burst.

## Win / Loss vs top competitor

A weekly split of how many SKUs you **win** (priced at or below) versus **lose** (priced above) against your primary competitor - the one that covers the most of your SKUs, picked automatically. Read the trend: a rising loss line means the competitor is pulling ahead on price across more of your range week over week.

## Competitor Move Heatmap

A grid of competitor price moves broken down by **competitor x category**, so you can see *who* is repricing *where*. A hot row is a competitor on the move across many categories; a hot column is a category under pressure from several competitors at once. Use it to aim the next pricing pass at the categories taking the most heat.

## Make it your own

The built-in dashboard is a starting point. Open it in the [dashboard editor](/dashboards/editor) to add, remove, or rearrange tiles, or describe a different view in plain language with [Create a dashboard with AI](/dashboards/create-with-ai). A built-in dashboard can always be reset to its default.

## Related

* [Dashboards overview](/dashboards/overview)
* [Create a dashboard with AI](/dashboards/create-with-ai)
* [Metrics glossary](/reference/metrics)
* [Competitor prices data spec](/data-requirements/competitors)