Progress
Bar / ring percentage. What the progress is for, the data it needs and every option it has.
5 min read
On this page
Bar / ring percentage. It sits in the Single value group of the widget library.
When to use it#
Use progress to show one value as a share of a maximum, as a ring, half ring or bar. For example, show how much of a savings goal is reached, how much of the monthly budget is spent, or how many transactions have been categorised.
When to pick something else#
- A value against a target and ranges on a scale? Use a Meter.
- A dial with good, warning and bad zones? Use a Gauge.
- The number itself, with its change? Use a KPI.
- Several goals side by side? Use a Bullet chart.
The data it needs#
Pick these in the Data tab of the inspector. BankSync suggests a column for each when your source has an obvious match.
| Field | Needed | Pick | Notes |
|---|---|---|---|
| Value | Yes | a number |
Each row is drawn as it is, so shape the rows first if you need totals. See Shaping data.
Progress options#
Set these on the Style tab of the inspector. "Automatic" means BankSync picks a value from the chart's size and data.
| Option | What it does | Values | New charts start with |
|---|---|---|---|
| Value column | The column the number comes from. Its values are added up into one number. | Text | value |
| Maximum | The value that counts as 100%. | Number | 100 |
| Shape | A bar, a ring, or a bar split into segments. Leave empty to pick a bar on wide cards and a ring otherwise. | Bar, Ring, Segments | Automatic |
| Orientation | Lay the bar horizontally or vertically. Vertical picks a bar unless you choose another shape. | Horizontal, Vertical | Automatic |
| Corner radius | Rounds the ends of the bar or ring, in pixels. 0 gives square ends. | Number, 0 or more | Automatic |
| Thickness | Thickness of the bar or ring, in pixels. | Number, 0 or more | Automatic |
| Show percentage | Write how far along the value is, as a percentage. On by default. | On or off | Automatic |
| Show value | Also write the value and the maximum, such as "$450 of $1,000". | On or off | Automatic |
| Segments | Split the bar or ring into this many blocks (2 to 60). The segments shape uses 10 when empty. | Whole number, 0 to 9007199254740991 | Automatic |
Number format#
How the number is written: currency, percent, decimals and locale.
| Option | What it does | Values | New charts start with |
|---|---|---|---|
| Format | The kind of number: plain, currency, percent, accounting, scientific, compact (1.2K), date, time or duration. Percent expects a fraction, so 0.25 shows 25%. | Number, Currency, Percent, Accounting, Scientific, Compact, Date, Time, Duration | Automatic |
| Locale | Language and region for separators and symbols, such as en-US or en-AU. Defaults to en-US. | Text | Automatic |
| Currency | Three-letter currency code such as USD, AUD or EUR. Defaults to USD. | Text | Automatic |
| Decimal places | Show exactly this many digits after the decimal point. | Number | Automatic |
| Sign | When to show a plus or minus sign: automatically, always, for non-zero values only, or never. | Auto, Always, Except zero, Never | Automatic |
| Time zone | Time zone for date and time formats, such as Australia/Sydney. Leave empty for the viewer’s own. | Text | Automatic |
Colour steps#
Colours the fill changes to as the value grows. Named steps are marked on the track. Add as many as you need; each one has:
| Option | What it does | Values | New charts start with |
|---|---|---|---|
| Starts at | Where this step starts, as a fraction of the maximum (0.8 is 80%). The fill takes the colour of the highest step reached. | Number, 0 or more | Automatic |
| Step colour | Colour of the fill once the value reaches this step. | Colour | Automatic |
| Step name | Optional name; a named step gets a tick across the track. | Text | Automatic |
Shared chart styling#
Every chart also has the shared styling options. These apply to this one:
- Legend: position, layout and which series show.
- Axes: titles, tick labels and number format.
- Grid, title, padding and background.
- Value labels on the marks.
- Categories and labels: top N with "Other", sort order, readable labels, the handwritten callout.
- Style: corner radius, line width, opacity and animation.
- Tooltip on hover.
- Colours: follow the dashboard palette or pick one for this chart.
Messy data#
- All rows are added into one value by default.
- With no matching rows it shows 0%, not an empty message.
- The maximum defaults to 100. A maximum of zero or below shows "Set a maximum above 0".
- A value past the maximum fills the mark, keeps the true percent (for example "172%") and adds an "over" marker. A negative value leaves the mark empty while the percent stays negative.
On a phone#
Unless you choose a shape, a wide and short cell gets a bar and a squarer cell gets a ring. On phones the cell is fairly square, so you usually get a ring; choose the bar shape if you want a thin strip.
Related charts#
Use this page with your AI assistant
Every BankSync doc is available as plain Markdown for agents and LLMs.