> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pba/10.2-analytics/pentaho-dashboard-designer-cp/create-a-chart/chart-types/dial-charts.md).

# Dial charts

Dial charts are often associated with Key Performance Indicators (KPIs). Dial charts are circular and contain a scale, a needle, and one or more a dial sectors. The dial sector is used to identify a specified area on a dial chart using a particular color. For example, you could have a dial plotting inventory with a minimum dial value of 10000 and a maximum dial value of 50000. There could be a red dial sector for the region between 2000 and 4000 indicating that if the needle is in this area, there is a danger of a supply inventory shortage.

For dial charts to display correctly, you must enter values for your range and the chart title. In the example below, the dial chart preview is displaying ranges associated with sales. Notice that each dial sector is represented by a color, red, yellow, or green. The needle is positioned in the 220796.48 range, indicating that total orders, while not stellar, are not near the danger zone indicated by the red sector in the dial.

![Dial chart](/files/5R3j6zr0Jq9ZG143OUsR)

You can change the color of a dial sector by clicking the small down arrow in the color boxes associated with **Range**. Select a color from the palette so that you can preview it on your dial chart. Click **Apply** to preview your dial chart. Click **OK** to place your dial chart into the dashboard.

![Color picker](/files/RlPtw6LU5QdNgsdqgvgm)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/pba/10.2-analytics/pentaho-dashboard-designer-cp/create-a-chart/chart-types/dial-charts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.