> For the complete documentation index, see [llms.txt](https://help.chartplugin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.chartplugin.com/how-to-create-your-first-chart/create-progress-chart.md).

# Create Progress chart

### Overview

Progress (Solid gauges) display progress against a target using a circular arc. Think of them as minimalist speedometers for KPIs.

### When to use it

* Highlighting a single metric vs. goal (e.g., completion rate, NPS).
* Creating dashboard tiles where quick status recognition matters.
* Showing a range with clear minimum/maximum thresholds.

Avoid gauges when comparing many categories—use bar charts or sparklines instead.

### Data requirements

* Single numeric value.
* Works best with percentages or values bounded between min and max.

### Style options available

| Group                  | Control          | Input type | Options     | Description                                                        |
| ---------------------- | ---------------- | ---------- | ----------- | ------------------------------------------------------------------ |
| Colors                 | Color palette    | palette    | —           | Palette applied to series; sets the default colours for the chart. |
| General → Progress     | Inner size, %    | text       | —           | Inner radius of the filled gauge arc.                              |
| General → Progress     | Rounded ends     | boolean    | —           | Rounds the ends of the solid gauge arc for a pill-shaped look.     |
| General → Background   | Inner size, %    | text       | —           | Inner radius of the gauge background ring.                         |
| General → Background   | Start angle, deg | number     | —           | Angle where the gauge arc begins, in degrees.                      |
| General → Background   | End angle, deg   | number     | —           | Angle where the gauge arc ends, in degrees.                        |
| General → Background   | Type             | select     | circle, arc | Shape used for the gauge pane (e.g., solid arc).                   |
| General → Background   | Color            | color      | —           | Colour of the gauge background ring.                               |
| Title → Chart title    | Font name        | text       | —           | Font family used for titles, labels, or legend text.               |
| Title → Chart title    | Font style       | text       | —           | Font weight or style (e.g., bold, italic).                         |
| Title → Chart title    | Font size        | number     | —           | Font size in pixels for the selected text element.                 |
| Title → Chart title    | Font color       | color      | —           | Colour of the text shown for this element.                         |
| Title → Chart title    | Margin bottom    | number     | —           | Extra space below chart titles or subtitles in pixels.             |
| Title → Chart subtitle | Font name        | text       | —           | Font family used for titles, labels, or legend text.               |
| Title → Chart subtitle | Font style       | text       | —           | Font weight or style (e.g., bold, italic).                         |
| Title → Chart subtitle | Font size        | number     | —           | Font size in pixels for the selected text element.                 |
| Title → Chart subtitle | Font color       | color      | —           | Colour of the text shown for this element.                         |

> 🎯 **Tip:** Pair the progress with a concise subtitle (“Goal: 85%”) to give readers instant context.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


---

# 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://help.chartplugin.com/how-to-create-your-first-chart/create-progress-chart.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.