> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/processes/shape-repository/user-task/candidate-user-expressions.md).

# Candidate user expressions

A candidate user is a user who can perform a workflow task. You can specify candidate users by using candidate user expressions, such as `role(Business Steward)`, `user(John)`, or `group(Data Custodians)`.

You can include a comma or other punctuation marks, except semicolon, in your candidate user expressions. If you use punctuation marks, you must enclose the user expressions in curly brackets, for example `{role(Business Steward; Community, Inc)}`.

{% hint style="success" %}
It is best practice to use curly brackets for all user expressions, whether the user expression contains a punctuation mark or not.
{% endhint %}

In Workflow Designer, add the candidate user expression and use <kbd>Enter</kbd> to confirm each entry. You can add multiple expressions.

<img src="/files/Gbd062dq117J1KR3LXKR" alt="Multiple candidate user expressions in Collibra Workflow Designer." width="50%">

When using a variable to store candidate user expressions, ensure the value is a String representation of one or more comma separated expressions, for example `{user(John)}, {user(Eliza)}, {group(Data Custodians)}`

| Expression                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| role(\<roleName>)                                  | <p>Assigns the task to users with the specified role on the workflows business item. In case of a global workflow, you can use global role names.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Business Steward)}</code> assigns the task to users with the <strong>Business Steward</strong> role.</p></div></div>                                                                                                                                                                                                                                                                                                |
| role(\<roleName>;\<communityName>)                 | <p>Assigns the task to users with the specified role on the specified community. This is independent of the current workflow business item.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Business Steward;Sales Community)}</code> assigns the task to users with the <strong>Business Steward</strong> role in the <strong>Sales</strong> community.</p></div></div><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This expression includes any inherited responsibilities.</p></div>                                                                                      |
| role(\<roleName>; \<communityName>; \<domainName>) | <p>Assigns the task to users with the specified role on the domain with the specified name in the given community. This is independent of the current workflow business item.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Business Steward;Sales Community;Pre Sales)}</code> assigns the task to users with the <strong>Business Steward</strong> role on the <strong>Pre Sales</strong> domain in the <strong>Sales</strong> community.</p></div></div><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This expression includes any inherited responsibilities.</p></div> |
| role(\<roleName>;\<entityLevel>)                   | <p>Assigns the task to users with a role on the workflow business item, but only if they have the role on the specified level. Possible entity levels are Term, Vocabulary and Community, which respectively indicate roles to be on the Asset, Domain or Community level.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Business Steward;Term)}</code> assigns the task to users with the <strong>Business Steward</strong> role on the asset.</p></div></div>                                                                                                                                                     |
| role(\<roleName>;\<relationName>)                  | <p>Assigns the task to users with the specified role on assets that are related to the current workflow business item with the given relation name.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Stakeholder;Complies To)}</code> assigns the task to stakeholders of assets that are related by the <strong>Complies To</strong> relation.</p></div></div>                                                                                                                                                                                                                                                        |
| role(\<roleName>; \<entityLevel>; \<relationName>) | <p>A combination of the role(\<roleName>; \<entityLevel>) and role(\<roleName>; \<relationName>) expressions. This expression assigns the task to users of the target-related asset with a role on the given entity level.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{role(Stakeholder; Term; Complies to)}</code> assigns the task to stakeholders on the <strong>Asset</strong> level of assets that are related by the <strong>Complies to</strong> relation.</p></div></div>                                                                                                                                      |
| user(\<userName>)                                  | <p>Assigns the task to the user with the specified name.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{user(John)}</code> assigns the task to John.</p></div></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| group(\<groupName>)                                | <p>Assigns the task to the users in the specified group.</p><div data-gb-custom-block data-tag="tabs"><div data-gb-custom-block data-tag="tab" data-title="Example" data-icon="glasses-round"><p><code>{group(Data Custodians)}</code> assigns the task to the users in the <strong>Data Custodians</strong> group.</p></div></div>                                                                                                                                                                                                                                                                                                                                                                                       |