This JQL function can be used to search for users by checking against user properties that contain text values.

usersWithTextProperty(property, comparator, value) #Output: User list
Parser expressionDescription
assignee in usersWithTextProperty("country" , "=", "Germany")
This example returns all issues where the assignee's property country is equals to Germany.
reporter in usersWithTextProperty("country", "~", "usa")
This example returns all issues where the reporter's property country is equals to usa ignoring the case. So even, if the property was set to "USA" or "Usa", the function would count this as valid property value.
reporter in usersWithTextProperty("department", "matches", "(IT|HR)")

This example returns all issues where the reporter's property department is either IT or HR.

(warning) When using the matches comparator, the provided value must be a valid regex.

reporter in usersWithTextProperty("importance", "matches", "^.*(required).*")

This example returns all issues where the assignee's property importance contains the word required.

(warning) When using the matches comparator, the provided value must be a valid regex.

Parameters used in this function

ParameterInput (data type)Description
property

The name of the JWT user property.

comparator

The comparator used to compare the actual value with the expected value. Allowed comparators are:

ComparatorDescription
=Property must be equal to the specified value.
!=Property must not be equal to the specified value.
~Property must be equal to the specified value, ignoring the case.
!~Property must not be equal to the specified value, ignoring the case.
matchesA regex can be provided that must be fulfilled by the property.
doesn't matchA regex can be provided that must not be fulfilled by the property.
value

The value that will be used to check against the actual user property.

(warning) In case the comparator is "matches" or "doesn't match", this value must be a regex.

This function returns .

Short descriptionSearch for users by checking on their user properties.
Output

Label

Status
Tech review

Style guide