# Linear Gauge

The Linear Gauge in the KPI tool provides a clear and effective way to measure progress, performance, or comparisons against a target. With its sleek bar-like design, this highly customizable chart helps users visualize key metrics in a simple yet impactful manner. Below is a detailed guide to its features and settings.

<figure><img src="/files/qWapb2O24cFMFwrx5Vnk" alt=""><figcaption></figcaption></figure>

Here's a quick guide to create Linear Gauge in KPI:

<figure><img src="/files/FKZoyil2r0QwLaPnscbn" alt=""><figcaption><p>Adding Linear gauge to KPI by Powerviz</p></figcaption></figure>

## **Data Tab**

**Gauge Value**

* **Gauge Value Mode**: Use this mode to display the gauge value as a percentage (requires a gauge value field in percentage).
* **Actual-Target Mode**: Displays actual and target values (requires both actual and target fields).

<figure><img src="/files/I4fbvXFrkK08E8UZvJ2u" alt="" width="305"><figcaption></figcaption></figure>

**Actual Value Field (Only available in&#x20;*****Actual-Target Mode*****)**

* Specify the field to represent the actual value.

**Target Type (Only available in&#x20;*****Actual-Target Mode*****)**

* **From Data**: Target values are derived from a field.
* **Fixed**: A constant target value is used.

**Target Field (Only available in&#x20;*****Actual-Target Mode*****)**

* Choose the field representing the target value.

**Max Value Type**

* **None**: No maximum is applied.
* **From Data**: Maximum value is derived from a data field.
* **Fixed**: Use a constant maximum value.

***

## **Gauge Tab**

**Gauge Color with** [**Conditional Formatting**](/powerviz/kpi/edit-mode-introduction/kpi-charts/conditional-formatting.md)

* Set a default color for the gauge and apply rules for dynamic color changes based on conditions.

**Remaining Color with** [**Conditional Formatting**](/powerviz/kpi/edit-mode-introduction/kpi-charts/conditional-formatting.md)

* Define the color for the remaining portion of the gauge using conditional formatting.

<figure><img src="/files/s0HHa4M5Or5NAMvSAeUx" alt="" width="302"><figcaption></figcaption></figure>

**Gauge Radius**

* Customize the edge style of the gauge:
  * **Sharp**: Straight edges.
  * **Rounded**: Smooth, rounded edges.
  * **Custom**: Define a custom edge radius.

**Actual Marker**

* **Toggle On/Off**: Enable or disable the actual value marker.
* **Size**: Adjust the size of the marker.
* **Color**: Set the marker color.

**Target Marker**

* **Toggle On/Off**: Enable or disable the target marker.
* **Color**: Set the marker color.
* **Target Label Checkbox**: Show or hide the target label.
* **Auto Size Toggle (On/Off)**: Automatically adjust the marker size.
* **IBCS Target Marker Checkbox**: Enable or disable the International Business Communication Standards (IBCS) target marker.

**Data Labels**

<figure><img src="/files/TiZzcI9hcOpvK2X5ynMg" alt="" width="301"><figcaption></figcaption></figure>

* **Type**: Choose to display labels as *Actual* or *Percent* values.
* **Text Size**: Adjust the label font size.
* **Color**: Set the label color.

**Gauge Scale**

<figure><img src="/files/9NSeVscIGcbkgWd1jsY4" alt="" width="296"><figcaption></figcaption></figure>

* **Tick Mark Checkbox**: Enable or disable tick marks on the scale.
* **Tick Value Toggle**: Show or hide tick values.
* **Text Size**: Set the font size for tick values.
* **Color**: Choose the color for the scale text.

**Number Formatting**

<figure><img src="/files/PxrjEDUjj4jsf1wx1lP2" alt="" width="296"><figcaption></figcaption></figure>

* **Display Unit**: Select the unit for the gauge values:
  * None, Auto, Thousand (*K*), Million (*M*), Billion (*B*), Trillion (*T*).
* **Prefix**: Add a prefix to the values.
* **Suffix**: Add a suffix to the values.
* **Decimals**: Define the number of decimal places.
* **+Format**: Choose between `123` or `+123` for positive values.
* **-Format**: Choose between `-123` or `(123)` for negative values.
* **Percentage Checkbox**: Display values as percentages.
* **Comma Checkbox**: Enable or disable comma separators for numbers.

**Global Options**

<figure><img src="/files/xI4CkXiFbViffF5R6tXT" alt="" width="296"><figcaption></figcaption></figure>

* **Font Family**: Select a font family for all text elements.
* **Styling**: Apply styling options such as Bold (*B*), Italic (*I*), or Underline (*U*).
* **Show Tooltip**: Enable or disable tooltips on hover.

***

## **Bands Tab**

<figure><img src="/files/oE4K7zPHW6NY9QOodimU" alt="" width="258"><figcaption></figcaption></figure>

**Display Type**

* Choose how bands are displayed:
  * **By Percentage**: Define bands based on percentage ranges.
  * **By Value**: Define bands based on specific values.

**Show Band Names in Chart Checkbox**

* Enable or disable band names within the chart.

**Band Name Color**

* Set the color for band names.

**Band Details**

* **Band Name**: Specify the name of the band.
* **Value**: Define the range or value for the band.
* **Color**: Assign a color to the band.

***

## General tab

<figure><img src="/files/M019xr8Ve1uYxUVMipLY" alt="" width="308"><figcaption></figcaption></figure>

This is common tab for all visuals click [here ](/powerviz/kpi/edit-mode-introduction/kpi-charts/general-tab.md)to explore settings. You can adjust visual properties, manage formatting options, and fine-tune various features to align with your requirements. Make sure to explore each section for a complete configuration.


---

# 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.powerviz.ai/powerviz/kpi/edit-mode-introduction/kpi-charts/linear-gauge.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.