The progress bar component renders a horizontal or vertical bar that shows current progress toward a target value. Use it for completion percentages, unit throughput, headcount fill rates, or any metric where visualising the gap to target matters.
When to use
- Overall project completion % vs planned completion %.
- Quantity installed vs quantity required.
- Document submission count vs contract obligation.
- Resource fill rate vs required headcount.
Adding the component
- Open the report output in the Output Designer.
- Click + Insert → Progress Bar.
- Position and resize the component.
- In the Data tab, bind value, target, and optional threshold fields.
Data binding
| Property | Description |
|---|
| Source section | Blueprint section containing the value and target fields. |
| Current value field | Numeric, currency, or percent field for current progress. |
| Target value field | Numeric field for the 100% target (or the plan value for this period). |
| Planned value field | Optional — show a separate planned marker on the bar. |
| Label field | Optional — field for the bar label (shown left of the bar). |
Layout
| Property | Options |
|---|
| Orientation | Horizontal (default) or Vertical. |
| Bar height | 8–40px for horizontal; 20–200px wide for vertical. |
| Stacked | Bind to a repeating section to render one bar per row (stacked bar list). |
| Sort (stacked) | Sort stacked bars by value, label, or field. |
| Max rows (stacked) | Limit bars shown (e.g. top 10). |
Value display
| Property | Options |
|---|
| Show current value | Show value text inside or beside the bar. |
| Show target value | Show target value at the right end of the track. |
| Value format | Percent, number, currency. |
| Planned marker | Vertical tick mark on the bar track at the planned value position. |
Colour and zones
| Property | Options |
|---|
| Bar colour | Static, or conditional on value range. |
| Threshold colouring | Define break points (e.g. < 60% = Red, 60–80% = Amber, > 80% = Green). |
| Track colour | Background track colour (default: light grey). |
| Planned marker colour | Colour of the planned value tick (default: dark grey). |
Label and caption
| Property | Description |
|---|
| Title | Static or field-bound title above the bar. |
| Value label | "X of Y" or "X%" format. |
| Delta | Show change vs prior period (e.g. "+3% since last report"). |
| Status badge | Optional RAG or toggle badge beside the bar. |
Export behaviour
- PDF / Word: Renders as a filled rectangle; all colour zones are preserved.
- Excel: Embedded as a static image; the underlying value and target are exported as a separate row.