KPI charts

The KPI chart type is part of the new answer experience. The new answer experience is on by default. If you have the classic answer experience on, your user interface and experience may be different from the experience described in this article. You can turn the new answer experience on or off individually from the Experience manager panel in your profile. If that option is not available, contact your administrator.

You can create visualizations of your data’s Key Performance Indicators (KPIs). Use this feature to track the changes in important KPIs in your data. When you configure the KPI chart to suit your business use case, you can save it as an Answer, add it to a Liveboard to increase visibility, or create alerts to receive notifications on the changes in the KPI using the Monitor feature.

KPI visualization example

When you search a single measure, such as Sales, ThoughtSpot automatically creates a KPI chart displaying the topmost value of that column. If you search multiple terms, you can configure the column visualized in your KPI chart. To tailor the KPI visualization to your business use case, you can add time comparison keywords such as “weekly” or “monthly” to change the aggregation of your KPI, use the chart configuration menu to decide how much information to display, or apply conditional formatting.

KPI charts for attributes

You can visualize an attribute (string, date, boolean value) as a KPI chart. This feature allows you to create KPIs for values such as "Date" or "Product".

KPI date chart example

To create an attribute KPI, follow these steps:

  1. Search for the attribute in the Search bar.

  2. A table displaying all values of the attribute appears. To view the KPI chart, choose one option:

    • Select the table to chart toggle above your Answer and select the chart icon.
      Table to chart toggle icon image

    • Select the chart icon Chart icon image to the right of your Answer and choose the KPI chart option.

  3. If your search contains multiple columns, select the chart configuration icon chart configuration icon image to the right of your Answer. Drag and drop the attribute column into the visualized section to visualize it in the KPI chart.

Please note that if your query returns more than one row of results, the KPI chart displays the topmost value from the result table.

Configure visualized columns

If you search multiple measures or attributes, the KPI chart automatically displays only the first search term. To create a KPI chart based on another measure or attribute from your search, select the chart configuration icon chart configuration icon image and drag and drop the currently visualized column to the Not visualized section. Select the new measure or attribute from the Not visualized section and drag and drop it into the Visualized section.

If you include time column (columns of type Date, Datetime, Timestamp and Time) or time period keyword (Hourly, Daily, Weekly, etc.) in your search, the keyword appears in the Time axis section.

Time-series aggregation in KPIs

If you search a measure or attribute with a keyword comparing across time periods, such as Sales weekly, your KPI visualization displays data corresponding to the most recent date bucket associated with your search. For a measure KPI, the percent increase or decrease in that data from the previous data point appears.

In the following example, the total sales for the week of 02/21/2022 was 3.21M. This measure increased 0.2% compared to the total sales for the previous week, 3.2M. Here, “WoW” signifies that the percent change is calculated week-over-week. You can also search a measure by day (DoD), month (MoM), quarter (QoQ), or year (YoY).

KPI visualization example 2

To create a KPI chart that displays the change between two specific date buckets, define the time periods for comparison in the search bar. For example, to compare the change in sales between this quarter and the previous quarter, search for sales quarterly this quarter last quarter.

You can only create KPI charts with data arranged in ascending, or chronological, order. You cannot create a KPI chart from any search using “date descending” as a filter.

For more information on using time period keywords in search, see Time series analysis

Sparkline visualization for time-series KPIs

When you search for a measure with a time-series keyword, for example Sales monthly, your KPI chart automatically displays a sparkline visualization of all the data points defined in your query. For ease of comparison, the two most recent data points are highlighted in the sparkline visualization. When the date bucket defined by your query is in progress (for example, a sales weekly KPI you consult on a Wednesday), your sparkline visualization shows a dotted line between the last data point and the accumulated value by the latest date.

KPI chart sparkline example

To see the exact value of the metric and corresponding date for each data point, hover over the sparkline visualization .

KPI chart sparkline hover example

Configure KPI display options

When you create a KPI chart with a time period keyword, you can change the display options before saving as an Answer or pinning to a Liveboard.

Click the chart configuration icon Chart configuration icon image and select Settings to make the following display changes:

  • Show Date Label to display or hide the date label.

  • Show Sparkline to display or hide the time-series visualization.

  • Show Comparison to display or hide the percentage change since the last period selected.

  • Positive change color to change the color of the percentage increase label.

  • Negative change color to change the color of the percentage decrease label.

Apply conditional formatting

You can add visual cues for KPIs or threshold metrics to easily show where you are falling short or exceeding targets. These visual cues are called conditional formatting, which applies color and font formatting to your search result. Add conditional formatting to show the threshold(s) you defined, and the data that falls within them will be shown using the same color.

Conditional formatting affects the text of a KPI visualization, it does not appear in sparkline visualizations.

To apply conditional formatting to your KPI, follow these steps:

  1. Select the Edit chart icon Chart configuration icon image to the right of your KPI.

  2. Select the measure tile under the Visualized section, for example, “Total Sales”.

  3. Under the Conditional formatting drop-down, select +Add rule.

  4. Define the values of your range and set the formatting options. In the following example, the KPI text turns red and bold when its value satisfies the condition, “between 180,000 and 200,000.”

    KPI chart with conditional formatting

  5. Select Add.

View the conditional formatting rule(s) applied to a KPI by selecting the information icon Information icon image that appears to the right of the measure.

KPI chart with conditional formatting information

KPI change analysis Beta

You can now use SpotIQ analysis to directly identify the key drivers for recent change in your KPIs. KPI change analysis allows you to drill down into the causes of change in your KPIs and customize the insights generated by SpotIQ.

To access this feature, go to your KPI chart and select the caret icon to the right of the percent change label. The Run change analysis pop-up allows you to customize the columns ThoughtSpot analyzes. Note that ThoughtSpot runs change analysis between the two most recent data points defined by the KPI’s time bucket (for example, daily or weekly).

For more information on comparative analysis in ThoughtSpot, see Change analysis.

Monitor your KPI

When you pin a KPI visualization to a Liveboard or save it as an Answer, you can create alert notifications for yourself and others. You must have view access to the KPI’s data source to schedule notifications for yourself. You must have edit access to the underlying data source to schedule notifications for teammates regardless of whether they have access.

For more information on the Monitor feature, see Monitor Key Performance Indicators in your data.


You can’t create a KPI chart with a group aggregation function.