> 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>                                                                                                                                                                                                                                                                                                                                                                                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/designing-workflows/processes/shape-repository/user-task/candidate-user-expressions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.