Skip to main content Skip to complementary content

KPI

The KPI visualization can show one or two measure values, and is used to track performance.

A KPI visualization with two measure values, using conditional colors and symbols.

KPI visualization.

When to use it

Use KPIs to get an overview of performance values that are central to an organization. Use color coding and symbols to indicate how the figures relate to the expected results.

Advantages

KPIs give a quick understanding of the performance within an area.

Disadvantages

The KPI is somewhat limited when it comes to graphical components. You can use symbols to help illustrate the performance, but if you want a more conspicuous component, consider using a gauge.

Creating a KPI

You can create a KPI visualization on the sheet you are editing.

  1. From the assets panel, drag an empty KPI chart to the sheet.
  2. Click Add measure and select a measure or create a measure from a field.

In a KPI visualization, you can have one or two measures and no dimensions. With two measures, the second value automatically becomes a complementary value and is shown with a smaller font size. You can easily switch their order by dragging the measures in the properties panel under Measures.

When you have created the KPI visualization, you might want to adjust its appearance and other settings in the properties panel. For information about styling, see Styling the KPI. For information about customizing other aspects of the chart's appearance, see Changing the appearance of a visualization.

The following settings are used by default in a KPI visualization:

  • Centered alignment.
  • Black text color.
  • No background color.
  • Responsive layout behavior.
  • Medium font size.
  • No titles.
  • Measure label displayed.
  • Conditional colors and symbols are turned off.
  • No link to sheet.
Tip noteIf you double-click or drag a measure from the assets panel, a KPI visualization is added on the sheet using the measure.

Styling the KPI

You have a number of styling options available under Appearance in the properties panel.

Click Styling under Appearance > Presentation to further customize the styling of the chart. The styling panel contains various sections under the General and Chart tabs. You can reset your styles by clicking next to each section. Clicking Reset all resets styles in both General and Chart.

Customizing the text

You can set the text for the title, subtitle, and footnote under Appearance > General. To hide these elements, turn off Show titles.

You can style the text in the title area.

  1. In the properties panel, expand the Appearance section.

  2. Under AppearancePresentation, click Styling.

  3. On the General tab, set the font, emphasis style, font size, and color for the following text elements:

    • Title

    • Subtitle

    • Footnote

Customizing the background

You can customize the background of the chart. The background can be set by color or to an image.

  1. In the properties panel, expand the Appearance section.

  2. Under AppearancePresentation, click Styling.

  3. On the General tab of the styling panel, select a background color (single color or expression) or set the background to an image from your media library.

    When using a background image, you can adjust image sizing and position.

Using conditional colors and symbols

You can set your KPI visualization to display in different colors, and with different symbols, depending on the value of the selected measure. Conditional colors and symbols can be configured in the properties panel.

You can do this by adding multiple range limits to the KPI, creating subsections that indicate performance. For example, you can set your KPI so that it displays in:

  • Green with a check mark symbol when performance is strong.

  • Yellow with a caution symbol when performance falls below expectations.

  • Red with an X symbol when performance is low.

You can also set range limits with expressions, rather than defining a single value.

  1. In the properties panel for a KPI visualization, select Appearance and expand Color.

  2. If necessary, turn off Library colors and turn on Conditional colors.

  3. Click Add limit to create a new limit. Multiple limits can be added to a single KPI chart.

  4. Specify a value for the limit, or enter an expression using the expression editor.

  5. On the Value color bar, click the range area of the KPI you would like to modify.

  6. Under Colors, select a preset color or use a custom color. Toggle, if needed, to Symbols to choose the symbol displayed when your KPI falls within the specified limit.

Linking to another sheet

You can link from the KPI visualization to a sheet in the app. When making data analysis and clicking the visualization, you can click a second time to go to a predefined sheet. The sheet is opened in a new tab. When hovering over Info, the name of the sheet is displayed. The icon is only displayed when Show title is selected, under Presentation.

Related learning:

Learn more

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!