--- title: "Single KPI" slug: "single-kpi-12-1" updated: 2026-03-31T10:13:03Z published: 2026-03-31T10:13:03Z canonical: "docs.bazefield.com/single-kpi-12-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.bazefield.com/llms.txt > Use this file to discover all available pages before exploring further. # Single KPI This page describes how to configure the *Single KPI* widget. The general description of this widget can be found here: [Single KPI Widget Documentation](/product/docs/single-kpi-1-1-1). This widget is intended for use in [Dashboard applications](/product/docs/create-dashboard-application-1) and [Report applications](/product/docs/create-report-application-1). This widget supports the following datasources: - Point Datasource - Availability Statistics ## Configuration ### General Tab This tab is composed of two sections: - *App Linked Data Sources*: Displays all usable data in the widget. ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-EU2Y8LPT.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - *Output configuration*: The output configuration allows to choose which points the widget will show. ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-SOKS453G.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) #### App Linked Data Sources For details on Linked app datasource see [Widget Configurations](/product/docs/widget-configurations-1). #### Output Configuration The output configuration allows to choose which points the widget will display as a KPI. If **Aggregate multiple points** is disabled, only one point can be selected. It is mandatory, as it is the main information displayed. If **Aggregate multiple points** is enabled, one or more points can be selected. Choose which Aggregate method to apply (Sum or Average): ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-0RJRMF9W.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - Click the ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-6167LCSQ.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) button ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-1HYNVP4G.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - Enter the following information: - *Data*: Select the data point(s) to display as a KPI - *Type*: Aggregated or Realtime - *Unit*: If necessary, choose the unit that will be displayed; by default, the unit of the point is used. *Note: this does not convert from one unit to another; the displayed value remains unchanged.* - *Value Decimals*: number of digits to show after the decimal point - *Enable dynamic period*: when enabled, the selected period is dynamic (Year To Date, Quarter To Date, Month To Date, Week To Date): ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-2CJQ7NNZ.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) When *Relative to global filter* is disabled, the period end is based on the current date. When enabled, it is based on the global filter end date. **Optionally, a reference point can also be entered**, which will be displayed as a comparison value, juxtaposed with the KPI point, in the form “KPI/KPI_REFERENCE”. - Enable the “Use Reference Point” switch. A KPI_REFERENCE line is added: ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-VI19BOW4.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - Configure the reference KPI point in the same way as the main KPI point. If **Aggregate multiple points** is enabled, one or more points can be selected, and the aggregation method will be applied to both KPI and KPI_REFERENCE. ### Multistating Tab This tab allows to optionally enable conditional formatting of the KPI. Initially, multistate conditions are disabled: ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-XSQYAM36.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) Use the *Multistate conditions* switch to enable/disable conditional formatting. At any time, Multistate conditions can be disabled and re-enabled (the previous configuration is retained). When enabled, at least 2 conditions are present: ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-UVR2H02V.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - Define each desired condition by entering: - *Limit* (required): the threshold below or above which (depending on the operator) the condition applies. Note: One operator <= is created initially, then the operator is automatically assigned to > for any additional conditions. This implicitly defines ranges of values ​​over which conditions apply. - *Text Color* (optional): if enabled, choose a text color (using a color picker) that will be applied to the displayed value - *Background Color* (optional): if enabled, choose a background color (using a color picker) that will be applied to the displayed value - *Text* (optional): enter a static text that will replace the value - The ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-9KVTF3G9.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) button adds a new condition (to be defined). - The ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-IKJP4E75.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) button allows to remove a condition definition. **Example:** For this hypothetical configuration: ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-UTP4WKL9.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - for a value < 1000, the KPI widget will display: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28523%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - for a value between 1001 et 1500: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28524%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) - for a value above 1500: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28526%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) ### Advanced Tab ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-Q465MOIS.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) This tab offers optional formatting possibilities: - Common: - *Description*: A description or title that will be displayed before the KPI value. - Description style: applies specific formatting for the KPI description text - *Text Size*: a number specifying the size of the text - *Text Align*: aligns the text, either left, center or right - *Use custom text color*: use the color picker to choose the color of the text. **Only applies if multistating is not enabled or does not set a specific text color.** - Unit style: applies specific formatting for the KPI unit - *Text Size*: a number specifying the size of the text - *Use custom text color*: use the color picker to choose the color of the text. **Only applies if multistating is not enabled or does not set a specific text color.** - Images: - *Icon*: choose either an icon or an image that will be displayed next to the KPI value - icon: enter the icon code in the Class field. See the [reference of usable icons](https://fontawesome.com/icons) - image: use the ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-0XKBST2H.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) button to choose an image. Click on the *Clear* link will remove it. - *Background Image*: choose an image that will be displayed in the background of the KPI value. Click on the *Clear* link will remove the selected image. - Value style: applies specific formatting for the KPI value - *Text Size*: a number specifying the size of the text - *Text Align*: aligns the text, either left, center or right - *Use custom text color*: use the color picker to choose the color of the text. **Only applies if multistating is not enabled or does not set a specific text color.** - Icon style: applies specific formatting to the selected icon (does not apply to an image) - *Text Size*: a number specifying the size of the icon - *Use custom text color*: use the color picker to choose the color of the icon. **Only applies if multistating is not enabled or does not set a specific text color.** Example KPI display for this hypothetical configuration, with *Multistating* disabled: ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-8KPPQK2J.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image-7PQGEOTO.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A08%3A00Z&se=2026-11-06T22%3A08%3A00Z&sr=c&sp=r&sig=PDUE5ANEBQvCmoRd7U0mpX6jLasgS8tr%2Bbj0gWVmjU8%3D) ### Widget interactions tab The Single KPI widget can be synchronized to other widgets, see Widget synchronization.