Create and use a Key Performance Indicator card

A Key Performance Indicator (KPI) card is a method of evaluating the status of a measure by comparing key indicators to a target.

KPI cards can answer questions about your data, such as how close the indicator is to the target.


An environmental organization is keeping track of global greenhouse gas emissions with the short-term goal of reducing emissions below 1990 levels. A KPI card can be used to show the current emissions (indicator) compared to the 1990 level (target).

KPI card displaying the current global greenhouse gas emissions and 1990 levels

The same KPI card can also be displayed using a gauge layout, which shows a visual comparison of the indicator and the target.

KPI gauge comparing the current global greenhouse gas emissions to 1990 levels

Create a KPI card

To create a KPI card, complete the following steps:

  1. Select one of the following data options:
    • One or two number Number field or rate/ratio fields Rate/ratio field
    • A string field String field, including subfields from a date/time field Date/time field

      If you use a string field, the number displayed will be a count of features.


    You can search for fields using the search bar in the data pane.

  2. Create the KPI card by following these steps:
    1. Drag the selected fields to a new card.
    2. Hover over the Chart drop zone.
    3. Drop the selected fields on KPI.

You can also create charts using the Chart menu above the data pane or the Visualization type button Visualization type on an existing card. For the Chart menu, only charts that are compatible with your data selection will be enabled. For the Visualization type menu, only compatible visualizations (including maps, charts, or tables) will be displayed.

Usage notes

By default, a KPI card is displayed as a number value. You can use the Legend button Legend to change the parameters, style, and color of the card.

The Style tab Style changes the layout between Number and Gauge. The Number layout displays the numeric value of the indicator and target. The Gauge layout displays the indicator and the target, along with a minimum and maximum value, on a semicircular scale. The Style tab can also be used to change the KPI color both above and below the target (Number layout) or the KPI color and the target color (Gauge layout).

Use the Options tab Options to change the following settings:

  • If your layout is Number, the Options tab can be used to change the indicator and target values.
  • If your layout is Gauge, the Options tab can be used to change the indicator, target, minimum, and maximum values.
  • If your KPI card includes a target value, the Options tab can be used to change the target label.

When you create a KPI card, a result dataset Results with the indicator value is added to the data pane. The result dataset can be used to find answers with nonspatial analysis using the Action button Action.

KPI cards using a Number layout can be resized smaller than the default card size. The font size for the indicator will change dynamically to fit the card as the size is decreased. The Gauge layout uses the default card size as the minimum.