An Assignment Rule lets you set up automatic assignment of documents to Users.

Assignment Rule will be useful in a scenario like—you have a support team and incoming support tickets. To assign the support tickets automatically amongst the employees who work on support, an Assignment Rule can be used.

To access Assignment Rule, go to:

Home > Settings > Assignment Rule

How to create an Assignment Rule

To set up an automatic assignment:

Go to the Assignment Rule list, click on New.
Select the Document Type you want to assign automatically (for example Issue).
Write the "Description" that will be added to the To Do.
Select the condition for the assignment. You can write simple Python expressions for automatic assignment in the Assign Rule, Close Rule and Unassign Rule. You will have access to all the properties of the document and can use operators like >, <, ==, etc and also multiple conditions like and and or.


status == "Open"
issue_type == "Technical" and priority=="High" and status == "Open"

Select the assignment rule (Round Robin or Load Balancing).

Round Robin: Assign each document to a User in sequence.
Load Balancing: Assign new documents to the User who has the least number of assignments.

Select the list of Users to whom this Assignment Rule will apply.


You can use properties of the document in the Description field that will be part of the assignment. Higher 'Priority' Assignment Rules will be applied first.


High Priority Issue File Upload not working has been assigned to you.

Multiple Assignment Rules

You can also set up multiple auto assignments for each Document Type, the one with the highest Priority will be applied first:

Here is an example of an Assignment Rule.

Set Document Type, Descriptions and Conditions.

Setting Due Date for assignment

You can auto set due dates for assignments based on the date field in the reference document.


If you want to set a due date on Issue assignment based on the "Resolution By" date of the Issue, you can do so by selecting "Resolution By" field in Due Date Based On option in Assignment Rule.

Notes: "Due Date Based On" option will not be available if "Document Type" is not yet selected or if the selected Document Type does not have any "Date" or "Datetime" field. Due Date in the assignment/ToDo will be updated whenever the "Due Date Based On" field value is updated in the reference document.
Was this article helpful?
Thank you!