Loading...
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Gauge Chart Widget (CX)

What's on This Page:


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


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.

Example of a Gauge Chart in a dashboard

When you hover over a gauge chart, you can see the full range of values and their corresponding colors.

Same gauge chart, with mouse hovered over to show range in a tooltip

Qtip: The hover state is used when the widget is exported.

Field Type Compatibility

The gauge chart widget is compatible with the following field types:

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.

Widget Customization

For basic widget instructions and customization, visit the Building Widgets support page. Continue reading for widget-specific customization.

Qtip: You cannot adjust title alignment on a gauge chart widget.

Basic Setup

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.
Metric settings expanded on a Gauge Chart

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.

Value Ranges

Qtip: When setting your value ranges, if you would like to indicate decimals for cutoff points, please be sure to use a dot (.) instead of comma (,) when typing your entry.

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.
Value Ranges option highlighted in the editing pane

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.
the add comparison button on a gauge chart

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.
selecting a benchmark to add to the widget

Qtip: You can add multiple benchmarks to your widget.

You can then customize the following aspects of your benchmark:
choosing the metric, field, display type, and label for a benchmark

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