# Gauge chart

{% hint style="info" %}
Available in a focused view (when you select and focus on items in a dimension), in all modes except for Transaction mode.
{% endhint %}

A Gauge chart is one of the KPI types of chart. It displays performance within a range. Red, yellow and green each represent a range entered you set up, typically relating to business goals or targets. The pointer typically moves from red or yellow to green when a target is met or exceeded. If left blank, no color will appear. These charts are useful for representing values within a simple range, for example, percentages, as they are typically in the range 0-100.

Gauge charts can be used for many reasons, such as:

* To view data containing a comparison or variance, for example, sales vs. budget or profit this year vs. last year.
* To count a number of something. 
* To track performance against a target, such as Sales Rep performance, as illustrated in the dashboard image below.

<div align="left"><figure><img src="/files/SdseokWD8PfgzCstTOBY" alt="" width="544"><figcaption></figcaption></figure></div>

<details>

<summary>Example: Track Sales Rep performance against budget</summary>

In the Sales database, create a Gauge chart to visualize whether a Sales Rep is tracking against the budget.

Prepare the data in the grid:

1. Select the **Sales Rep** dimension, then select and focus on a particular rep (Bert).
2. Select **Period** > **Year to date**.
3. Select **Mode** > **Stream**, **Stream** > **Sales** and **Variance Stream** > **Budget**.

Click the **Chart** button in the top right toolbar above the grid, then click the **Gauge** chart category button on the left of the chart and select the **Gauge** option.

<img src="/files/xWVk9UhWtbEgrA50vVak" alt="" data-size="original">

The default Gauge chart displays but it is meaningless as you have not yet configured the chart settings. Configure the chart:

1. Select **Summary** > **% Variance**.
2. Select the **Show stream values** checkbox.
3. Enter the **Range** as -100 to 100, **Red** as -100 to 15, **Yellow** as -15 to 15 and **Green** as 15 to 100 (see image below).

   <div align="left"><figure><img src="/files/rGqXUK1IsWR8fd9y5nRh" alt="" width="442"><figcaption></figcaption></figure></div>

The chart updates; it now compares Bert’s sales performance against budget. You can see that Bert is over 80% ahead of his budget.&#x20;

</details>

{% embed url="<https://phocassoftware.wistia.com/medias/htmtoa8ozo>" %}
Create KPI-Style gauge, summary and bullet charts
{% endembed %}

***

{% hint style="success" %}
**Related pages**

You can take the following actions with your chart:&#x20;

[Configure the chart options](/analytics/visualize-your-data-in-a-chart/configure-the-chart-options.md) | [Select and focus on a chart segment](/analytics/visualize-your-data-in-a-chart/select-and-focus-on-a-chart-segment.md) | [Use the chart legend](/analytics/visualize-your-data-in-a-chart/use-the-chart-legend.md) | Save the chart as a favorite | Add the chart to a dashboard | [Export a chart as an image](/analytics/visualize-your-data-in-a-chart/export-a-chart-as-an-image.md)

See also the main page: [Visualize your data in a chart](/analytics/visualize-your-data-in-a-chart.md)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.phocassoftware.com/analytics/visualize-your-data-in-a-chart/gauge-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.