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

# KPI

> KPI visualizations highlight the metrics that matter most, with components for single values, comparisons, progress to a goal, sparklines, text, and images.

KPI visualizations spotlight key metrics and data points, from a single headline number to side-by-side comparisons and progress toward a goal. Each KPI is built from one or more rows, and every row can be a different component type, giving you fine-grained control over layout and presentation.

<img src="https://mintcdn.com/omni-e7402367/p58E9rVtiNQIecNs/visualize-present/images/kpi/kpi-overview.png?fit=max&auto=format&n=p58E9rVtiNQIecNs&q=85&s=2e0d4d21da2e975e5b8fc3360ec6537a" alt="Overview of a KPI visualization showing several component types" width="2032" height="1320" data-path="visualize-present/images/kpi/kpi-overview.png" />

## Adding components

KPIs support several types of components, allowing you to customize the content and layout of your visualization. Click the **Add** button in the visualization to add a new component.

## Customizing components

To customize the display of a component, click the component in the visualization editor. Use the **KPI Builder** tab in the chart configuration options to make changes to the component.

## Component types

KPIs support several component types, each suited to a different way of presenting data. You can mix and match them within a single visualization.

### Number

Highlights a single value.

<Frame caption="A number component highlighting a single value">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/single-value.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=237b7423eb239f039414ab7a3c29e58f" alt="A KPI number component highlighting a single value" width="247" height="138" data-path="visualize-present/images/kpi/single-value.png" />
</Frame>

<Tip>
  Automatically scale the text size of number components by setting **KPI numbers** to **Dynamic size** in the chart configuration's **Style** tab. When set, numbers will dynamically change size as tiles are resized or dashboard layouts are changed. **Not supported for classic dashboards.**
</Tip>

### Comparison

Comparison components compare one value to another and support comparing across columns and pivots. Select the same column for both comparison fields to compare two rows within a dataset.

<Frame caption="A comparison component comparing one value to another">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/comparison.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=2934fe433d232bc4f737be551a83ba1a" alt="A KPI comparison component comparing one value to another" width="295" height="49" data-path="visualize-present/images/kpi/comparison.png" />
</Frame>

### Progress

Compares two values. Useful for showing progress to a goal. Can be displayed as a bar (shown) or a circle.

<Frame caption="A progress component shown as a bar">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/progress.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=3eb5d7744592e120afc10d06f3e2f8f7" alt="A KPI progress component shown as a bar" width="313" height="64" data-path="visualize-present/images/kpi/progress.png" />
</Frame>

<Tip>
  Compare to a static number - like a goal - by adding a column to the query that always returns the same number.
</Tip>

### Chart

Chart components display a mini sparkline, bar, or line chart. Renders a sparkline by default.

<Frame caption="A chart component rendered as a sparkline">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/chart.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=87545554c386da108356e0c0cbabe3d5" alt="A KPI chart component rendered as a sparkline" width="236" height="146" data-path="visualize-present/images/kpi/chart.png" />
</Frame>

### Text

[Markdown](https://www.markdownguide.org/cheat-sheet/) enabled free text. Useful for titles, headings, and descriptions.

For complex layouts, use the [Markdown visualization](/visualize-present/visualizations/types/markdown).

<Frame caption="A text component displaying Markdown-formatted text">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/text.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=7ccb21286f630236baf9febcd50dc798" alt="A KPI text component displaying Markdown-formatted text" width="216" height="57" data-path="visualize-present/images/kpi/text.png" />
</Frame>

### Image

Images display an inline image. Configured by providing a URL to a publicly accessible image.

<Frame caption="An image component displaying an inline image">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/image.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=1e1bddebb5dd0c41fa60b42f1071dd22" alt="A KPI image component displaying an inline image" width="1414" height="794" data-path="visualize-present/images/kpi/image.png" />
</Frame>

<Tip>
  Use [Mustache](/visualize-present/mustache-reference) to parameterize the URL. For example, `https://en.gravatar.com/{{result._first.users.img_link}}`
</Tip>

## Styling options

Use the **Style** tab in the chart configuration options to customize the alignment and text sizes for KPI components.

<Frame caption="KPI style configuration options">
  <img src="https://mintcdn.com/omni-e7402367/CYdgirGaCQII7pix/visualize-present/images/kpi/kpi-styling-options.png?fit=max&auto=format&n=CYdgirGaCQII7pix&q=85&s=1e77880ddbd6e8e1943c121a1aa6335a" alt="The Style tab of the KPI chart configuration options" width="402" height="440" data-path="visualize-present/images/kpi/kpi-styling-options.png" />
</Frame>

## Converting to raw Markdown

If you want to customize a KPI beyond Omni's built-in options, you can convert the visualization directly to Markdown by changing the visualization type to **Markdown**.

To undo changes, use the back button in your browser.
