KPI Configuration form

reference australia Updated Oct 22, 2026 2 min read kpi-configuration-form.md
Raw file servicenow.com

The KPI Configuration form helps you create a key performance indicator for the Space Planning module in Workplace Central.

Field

Description

Name

Name of the KPI Configuration. Note: The name must be unique.

Label

Display label that appears in the Space Planning workspace.

Application

Application scope in which the KPI Configuration record is created. The field is automatically filled based on the current application scope and can't be edited.

Active

Option to activate the record. When this field is selected, the KPI is calculated and displayed in the Space Planning workspace.

Order

Order of the KPI in the side panel. In the details panel, lower order values appear before the higher order values.

Description

Description that appears on a tooltip in the Space Planning workspace.

Type

The operation that is applied to the selected field. The operation is applied across all applicable spaces on the Space Planning workspace.Select one of the following values:

  • SUM: Calculates the sum of the values of the selected field.
  • AVG: Calculates the average of the values of the selected field.
  • COUNT: Counts the number of values of the selected field.
  • COUNT DISTINCT: Counts the number of unique values of the selected field.
  • None: Doesn't apply an operation. Use this value for KPIs that a script include calculates.

For example, SUM of Capacity displays the total capacity of the applicable spaces.

Each combination of Type and Computation field can be used in only one KPI configuration.

Note:

For KPIs that require multiple operations, you can set the type to None and create a script include to calculate the value. To create a script include, you can create an implementation by using the sn_wsd_spcmgmt.KPICustomConfig extension point.

For reference, you can view the Script Includes like KPI_profiles_assigned or KPI_assignment_ratio, which are included with Workplace Space Management.

For more information about extension points, see Using extension points to extend application functionality.

Computation field

Field on the Space [sn_wsd_core_space] table on which the selected operation is performed. This field is displayed only after you select a value in the Type field.Note: You must select a computation field when the type is SUM, AVG, or COUNT DISTINCT.

For example, SUM of Capacity displays the total capacity of the applicable spaces.

**Parent Topic:**[Workplace Space Management references](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/employee-service-management/workplace-space-management/workplace-space-mgmt-references.md)

Related topics

Allocation - types, setting, and impact

Components installed with Workplace Space Management

Properties installed with Workplace Space Management

View by Configuration form

Search documentation
Search document titles and file paths on the australia branch