# 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>.
