Skip to main content

Celonis Product Documentation

Assignment Rules

Introducing Assignment Rules

Assignment Rules provide an easy way to find and assign the proper assignee within Celonis Studio. This feature lets you match a specific input with a custom output (either a user, email, or custom text).


Assignment Rules that were created previously using PQL statements within Knowledge Models remain fully functional. However, due to the increased maintainability and ease of use, Assignment Rules' utilization is recommended over such manual solutions.

Exemplary Use Cases

Thanks to the open nature of Assignment Rules, they can be utilized for a broad spectrum of use cases. In a nutshell, most tasks involving the return of a value, based on a custom lookup, can be completed using Assignment Rules. Some examples include:

  • Assigning a task to a specific user based on certain criteria.

  • Setting email recipients on a per-case basis.

  • Expanding the source system through additional information.

Viewing Assignment Rules
  1. Go to the package settings.

  2. See the Variables tab for:

    1. The Assignment Rule variable type.

    2. An overview of the Assignment Rules for the respective package.



Assignment Rules are by default activated for every team using Knowledge Models. If you cannot see Assignment Rules in your package settings, please contact Celonis support. Remember to mention your team URL.

Step-by- step guide to Assignment Rule creation
Step 1: Creating a new Assignment Rule
  1. Navigate to Celonis Studio.

  2. Hover over the name of the package you want to enable Assignment Rules for and click the three vertical dots.

  3. Select "Settings" from the dropdown.

  4. Navigate to "Variables" in the settings window.

  5. Click "Create New Variable" and select "Assignment Rule".

Step 2: Providing your Assignment Rule parameters
  1. Create a Key for your Assignment Rule

  2. Optionally, add a Description to your Assignment Rule; a description can be helpful when revisiting your rule in the future.

  3. Define a Default Assignee. This assignee can be either a custom output or one of the existing users. The default assignee is used for every combination of input attributes that have not been assigned explicitly to a different output.

  4. Select the Knowledge Model of the input attributes.


Only published Knowledge Models can be selected here. See Version Control for more information on knowledge model publishing.

Step 3: Selecting a Record and defining input attributes
  1. After the previous selection of a knowledge model, the Record field becomes available.

  2. Click the Records dropdown and select one (or more) record you want to use as a basis for your input attributes.

  3. Select one or more Input Attributes you want to use for this Assignment Rule from the dropdown.

  4. Once an input attribute is selected, the table on the right of the dropdown will appear. It displays all distinct combinations existing in your data for the selected input attributes.


Knowledge Model Records

A Record is the definition of a core item that Celonis tracks in its process mining analysis (e.g. invoice, sales order, purchase order, etc.). For more information on Records see Knowledge Model Records.

Step 4: Navigating the Input Attributes Table
  1. After completing all previous steps, you can create assignees for the individual (and distinct) Input Attributes.

  2. On default, the Assignee column in this table will always display our previously created default assignee (see step 2).

  3. Above the table, you will find a dropdown menu for each of your input attributes. You can use these to filter for specific combinations you wish to assign.

Step 5: Creating a new Assignment
  1. After filtering the input attributes to your desire, you can select one or multiple rows using the checkbox on the very left of each row.

  2. Once one or more rows are selected, the Change Assignee button becomes available.

  3. To create an assignment for the selected instances, click Change Assignee. This will present you with the option to either use a free-text custom assignee (e.g. email) or assign it to an existing user.

  4. Click Save once you are happy with your assignments!



By default, an Assignment Rule will be used on zero Skills. To start using your newly-created Assignment Rule, see Applying Assignment Rules in Skills.