Skip to main content

Celonis Product Documentation

Creating View variables

View variables allow you to centrally create and manage information that is referenced and reused across components and assets, enabling you to update them in one location only.

You can use View variables in buttons, KPI lists, tables, and input dropdowns. For more information, see: Using variables in components

Creating View variables
  1. Click Variables - Create Variable:

  2. Enter a variable name, select a variable type, and optionally enter a description.

    • Key: This should be a unique ID, allowing for the variable to be referenced across components. Avoid using special characters here.

      Your variable key can then be referenced in your View as:

    • Type: Choose between string (text), number (#), boolean (true /false), and object.

      For object variables, see: Using Object variables.

    • Default Value (optional): This is the value that will be referenced unless otherwise stated.

  3. Optional: Enable Advanced Options and enter a variable description and choose the variable and user scope.

    • Description (optional): Provide further information here, giving your team added context where needed.

    • Variable Scope: Choose whether this variable is saved at a View level only, within the knowledge model (which can be referenced by all Views created using that model), or for all assets within the existing package.

    • User Scope: Choose whether this variable is specific to your account or is available for all users within your team.

  4. Click Save.

Once saved, your variables are then displayed in the variables menu. To edit or delete an existing variable, click Edit:

Using variables in components

Once created, you can reference variables in the following View components: buttons, KPI lists, tables, and input dropdowns.

Variables can either be added through the Interaction settings for components, such as with a KPI list:


Alternatively, variables can be referenced in PQL expressions using the following format:

Using Object variables

Object variables allow you to store the metadata of a particular metric or attribute in one single variable. This object variable can then be reference in View components such as input dropdowns, text boxes, and component fields.

The schema (i.e structure) for object variables is generated when a default value or a current value is set and follows the JSON syntax. As such, you need to define key-value pairs.

For example:

"key1": "String",

This is then added to the Default Value field when creating or editing the object variable:


Object variables are then referenced in the following ways:

  • PQL editor:

  • Component fields: