Skip to main content Skip to complementary content


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.


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


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.

For general information about styling an individual visualization, see Applying custom styling to a visualization.

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.

In a KPI, you can style the text in the following components of the chart:

  • Title area: Includes the chart title, subtitle, and footnote.

  • Chart area: Includes measure titles and measure values.

Styling the title, subtitle, and footnote

You can customize the text displayed in the title area of the chart.

  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

Styling the chart text

The data displayed in a KPI chart consists of text. The appearance of this text can be customized separately from the title area.

You can set the text alignment for the chart. Choose between left-aligned, centered, or right-aligned text.

You can also select between several layout behavior options. The layout behavior defines how the size of the text adapts given the configured font size, chart size, and text length. The following options are available:

  • Responsive: You can adjust the font size, with additional text size adjustments applied based on chart size and text length. Adjustments are made to fit all text content into the KPI.

  • Fluid: You can adjust the font size, with additional text size adjustments applied based on chart size only. This re-scaling of the text is independent of text length. If the text is too long, an ellipsis is inserted at the end.

  • Fixed: You can adjust the font size, but it does not automatically adapt to chart size or text length. It remains at the same size regardless of changes to these components.

Additionally, you can show or hide each of the measure titles in the KPI, and set the font size for the chart text.

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

  2. Under AppearancePresentation, click Styling.

  3. Navigate to the Chart tab.

  4. Under Alignment, set the text alignment. Choose between left, centered, or right alignment.

  5. Under Layout behavior, adjust how text size adapts to chart size and text length. The appearance of each setting depends on the Font size you set for the chart.

  6. Under Show, select whether to show or hide each KPI title in the chart.

  7. Under Font size, adjust the size of the text that displays the measure titles and values.

For further customization settings, you can set the Styling mode to Advanced options to style each measure title and measure value individually.

  1. In the Chart tab of the styling panel, under Styling mode, turn on Advanced options.

  2. Under First measure title, configure the following settings:

    • Set Show title on or off to display or hide the measure title.

    • Style the text. Choose the font, emphasis style, font size, and color.

  3. Under First measure value, set the font, emphasis style, and font size.

  4. Repeat the steps above to customize the Second measure title and Second measure value.

Customizing the background

You can customize the background of the chart. The background can be set by color and image.

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

  2. Under AppearancePresentation, click Styling.

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

    When using a background color, use the slider to adjust the opacity of the background.

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

Customizing the border and shadow

You can customize the border and shadow of the chart.

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

  2. Under AppearancePresentation, click Styling.

  3. On the General tab of the styling panel, under Border, adjust the Outline size to increase or decrease the border lines around the chart.

  4. Select a color for the border.

  5. Adjust the Corner radius to control the roundness of the border.

  6. Under Shadow in the General tab, select a shadow size and color. Select None to remove the shadow.

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!