Previous Report Builder: Gauge Chart

Add a gauge chart to the personalized PDF report to represent average or actual scores or percentage results for question blocks or formulas. Respondents can see at a glance if they've scored towards the top-end or bottom-end of the scale.


This graphical representation is usually used to show small numbers of values. Here's an example:

PDF: Gauge Chart- example

This guide will teach you:

  1. Setting up the widget
  2. Widget logic rules

1. Setting up the widget

1.1 Set thresholds

1.2 Other gauge settings

1.3 Widget placement and size

PDF: Gauge Chart- chart items

1.1 Set thresholds

After you've given a title to your graph that will be displayed above it, you need to set thresholds. The values you set for the thresholds will determine the shading of the progress bar. Change the shading so that a higher score will have a different or brighter shade than a lower score.

PDF: Gauge Chart- thresholds

  1. Use the arrows to set the threshold value. This must be a number between 0 and 1. The values entered will be converted into percentages, e.g. a threshold value of 0.1 will cover the first 10% of the bar.
  2. Click the color selector to change the color of each threshold. The default shades would color the bar in red for the lowest scoring answers, yellow for mid-ranking scores, and for top-scoring answers, the bar would be colored in green.
  3. If you want more than 3 colors of the progress bar, that's no problem! Simply click add threshold and add as many as you require. Keep in mind that the threshold value must be between 0 and 1!

The values for the thresholds must be entered in order, starting with the lowest value (threshold 1) and increasing to the highest value.


If a score is in between 2 thresholds, a mix of the 2 threshold colors will be shown on the gauge. In order to have it as 1 color, you need to set up minimum and maximum threshold values.

PDF: Gauge Chart- dimensions

Click Variables to access the drop-down menu of the variable on which you want the graph to be based. There's a whole range of options - it could be the answer to a formula, question block score, custom score, or very simply an answer to a particular question! Just make sure the variable is a numerical value otherwise the graph will not work.

1.2 Other gauge settings

Once the colors of the bar have been set, adjust the widget name and title. It's time to specify the other settings of the graph.

PDF: Gauge Chart- widget configuration extra options

  1. Use the arrows or enter a value for the lowest and highest value of the bar. The minimum value will be shown under the graph on the left-hand side, and the maximum value will be shown under the right-hand end of the graph. The Y-axis values can be any value you like (they do not have to be between 0 and 1 as the threshold values).
  2. Y-axis title - Name the progress bar. This title will show immediately on top of the bar, as opposed to the Title which is displayed in larger letters above the Y-axis title.
  3. Set number of decimal places - Set this to 0 if you do not wish to show any decimal places. Otherwise choose how many decimal places you want, bearing in mind that too many decimal places are not so useful to the report reader. If you choose to show 3 decimal places for example, then the value 1.559247 would be displayed as 1.559.

To make advanced design changes to the gauge chart, use custom CSS.

1.3 Widget placement and size

Choose how you would like to align your graph. You can choose to align it to one side and have explanatory text or another widget on the other side or center it.

PDF: Gauge Chart-widget placement and size

  • Left - widget will be aligned to the left side of the page, in a column layout
  • Center - widget will be presented centered across the entire page from the left to the right (full width)
  • Right - widget will be aligned to the right side of the page, in a column layout

If you would like a widget to appear side-by-side the graph, make sure to set the widget aligned on one side of the page and the graph on the other. For example, choose to align the text widget to the left, and align the graph to the right.

Use the arrows or enter a value for the graph height and width. If you choose to place it on either the left or the right side of the page, the graph will be automatically resized. You can also change the background to be either white or transparent.

PDF: Gauge Chart- chart dimensions


The max-width of one page is 810px. To leave some room for spacing the recommended  Width value is around 600px.

Click the Update preview button to see how the widget you've created looks like.

PDF: Gauge Chart- update preview

Take a look below at some different layout possibilities:

PDF: Gauge Chart- gauge example pdf

Now if you want to show the graph to all respondents, you're done! Just make sure to click save PDF and continue adding widgets.

2. Widget logic rules

If you want to only show this widget under certain conditions, it's time to set the widget logic rules. If you want to show a general widget that is visualized every time a PDF report is generated, you can choose not to include a widget logic rule. Learn more about Widget Logic

PDF: Gauge Chart- add rules

Once you've saved your logic rules, don't forget to save PDF and you're ready to add more widgets!

What's next?

  • Conditional Rendering is a way of displaying elements based on a condition. It allows you to create simple conditions inside a widget and reduce the number of widgets and rules. With Conditional Rendering, you can render different UI markups based on certain conditions.
  • The custom results by respondent table is a dynamic type of widget that will add records automatically to the table once you have set it up. You can set the maximum number of records to show and set the table to sort records from low to high or high to low.
  • The PDF text widget allows you to write and display your content in your report. You can use it to give further information about questions, give feedback or explain a particular answer. This is an absolutely essential building block of your PDF report.
Support is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.