--- title: "Single KPI" slug: "single-kpi-11-5" updated: 2026-02-11T09:39:17Z published: 2026-02-11T09:39:17Z canonical: "docs.bazefield.com/single-kpi-11-5" --- > ## 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). 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](/product/docs/point-1) - [Availability Statistics](/product/docs/availability-statistics-1) ## Configuration ### General Tab This tab is composed of two sections: - *App Linked Data Sources*: Displays all usable data in the widget. ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28503%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) - *Output configuration*: The output configuration allows to choose which points the widget will show. ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28504%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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 point the widget will display as a KPI. ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28510%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) Only one point can be selected. It is mandatory, as it is the main information displayed. - Click on the ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image(535).png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) button ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28516%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) - Enter the following information: - *Data*: Select the data point 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. The ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image(536).png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) button allows to enter a custom unit. *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 **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: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28518%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) - Configure the reference KPI point, in the same way as the KPI point. ### Multistating Tab This tab allows to optionally enable conditional formatting of the KPI. Initially, multistate conditions are disabled: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28520%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28521%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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(912).png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) button adds a new condition (to be defined). - The ![](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image(537).png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) button allows to remove a condition definition. **Example:** For this hypothetical configuration: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28522%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) ### Advanced Tab ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28528%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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(538).png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%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: ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28531%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D) ![image.png](https://cdn.document360.io/a0786c0f-b171-4b24-8860-c32eb7ef2738/Images/Documentation/image%28530%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A02%3A03Z&se=2026-11-06T22%3A02%3A03Z&sr=c&sp=r&sig=fu9hMVj%2FZDBi8PeTYhwTKlj4PC7Nu6L4FtDDewZcQ9s%3D)