About Gauge Chart Widgets
The gauge chart widget allows you to display the value of a particular metric on a set scale. The value is represented by a color bar progressing around an open circle, where the left end is the minimum value for this metric and the right end is the maximum value for the metric. In addition to the gauge bar, the widget will display the numeric value of the metric directly.
When you hover over a gauge chart, you can see the full range of values and their corresponding colors.
Field Type Compatibility
The gauge chart widget is compatible with the following field types:
- Number Set
- Numeric Value
- Measure Group
The gauge chart widget is primarily based off of the metric, and not directly off of a data field. The data field type will only matter if you are using a metric other than count. When using metrics that require a data field, you will only be able to select the Number Set or Numeric Value data fields.
For basic widget instructions and customization, visit the Building Widgets support page. Continue reading for widget-specific customization.
You will need to specify a metric when adding a gauge chart widget. When selecting Metric, you will need to give your metric a Label (i.e., a name) and choose the metric itself. If you choose a metric other than count, you will need to specify the field that the metric will be calculated off of. You can also select Options to specify whether or not you would like your metric in a number, percent, or currency format as well as the number of decimal places displayed.
Your available metrics include:
- Count: Display response counts from the selected fields (i.e., number of respondents choosing a value in a five-point scale)
- Average: Exhibit the average value for a selected field.
- Minimum: Show the minimum value of a selected field.
- Maximum: Present the maximum value for a selected field.
- Sum: Pull in the sum of all values for a selected field.
- Net Promoter Score: Identify the detractors, passives, and promoters from NPS questions.
Qtip: Gauge carts are frequently used to display NPS scores.
- Correlation: Input Pearson’s r value for the correlation between two fields.
- Top Box / Bottom Box: Display the percentage of responses that fall into a specified range of values.
- Custom Metrics: Include any custom metrics you have created. For more information, visit the page on Custom Metrics.
- Benchmarks: Any benchmarks you’ve created. However, this only adds the benchmark to the widget, no other data; to showcase your own data alongside a benchmark to see how well your data measures up, we advise following the instructions in the Comparisons and Benchmarks section below instead.
Enter values in the Min and Max boxes found in Value Ranges section to determine the values associated with the beginning and end of your gauge. In addition to the minimum and maximum values, you can set up to six intermediate values. For each value, set the color that you would like the gauge chart to be when the metric is less than or equal to that value.
If you’d like the value range to appear on the ring even when users aren’t hovering over the widget, select Show value range labels. Deselect this setting to only show these values on hover.
Comparisons and Benchmarks
You can add benchmarks to your gauge chart widget so you can compare your data with benchmark data. To add benchmarks to your widget, you must first create benchmarks in the dashboard benchmark editor. Once you’ve created benchmarks in your dashboard, you can add them to the widget by clicking Add Comparison.
After you’ve added your benchmark, click the pencil icon to edit the benchmark. You can then select your desired benchmark using the Metric dropdown menu. Your dashboard benchmarks will be at the bottom of the list.
- Field: Select the field that is used for the benchmark data
- Display Type: Choose between Display benchmark (which displays the benchmark’s raw value) and Display difference (which displays the difference between the benchmark and the primary metric).
- Label: Determine how the benchmark name appears in the widget.