> For the complete documentation index, see [llms.txt](https://docs.workflowgen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.workflowgen.com/admin/user-management/delegations.md).

# Delegations

## Delegations screen

In the left menu on the Administration Module home page, click ![](https://content.gitbook.com/content/ON9EaFhe3XOseoxlRqrD/blobs/9gqSCNXht1q8RzJ3Yn8z/left_menu_delegations_small.png) to display the **Delegations** screen.

<figure><img src="https://content.gitbook.com/content/ON9EaFhe3XOseoxlRqrD/blobs/q1LWp3WgnAPBojbz2ZTT/delegations.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

* Process folder managers can manage delegations for participants in Active or Archive process versions within folders they manage. They must select a managed process and one of its participants; general delegations and processes outside their scope remain unavailable.
* A delegation applies to the selected process version. Folder manager changes do not synchronize delegations across other versions; an Administrator can manage additional versions as required.
  {% endhint %}

## Menu banner

<table data-header-hidden><thead><tr><th valign="top">Buttons</th><th valign="top">Remarks</th></tr></thead><tbody><tr><td valign="top"><strong>Buttons</strong></td><td valign="top"><strong>Remarks</strong></td></tr><tr><td valign="top">Refresh</td><td valign="top">Refreshes the delegations list</td></tr><tr><td valign="top">New delegation</td><td valign="top">Displays a blank form to add a new delegation</td></tr></tbody></table>

## Filters

<table data-header-hidden><thead><tr><th valign="top">External filters</th><th valign="top">Remarks</th></tr></thead><tbody><tr><td valign="top"><strong>External filters</strong></td><td valign="top"><strong>Remarks</strong></td></tr><tr><td valign="top">Process drop-down list</td><td valign="top">Displays the delegations of the selected process (only active or archived processes are listed)</td></tr></tbody></table>

| **Filter on** | **Remarks**                      |
| ------------- | -------------------------------- |
| Participant   | Filter by participant            |
| Delegator     | Filter by user who delegated     |
| Delegatee     | Filter by user to whom delegated |

## Delegation list

<table data-header-hidden><thead><tr><th valign="top">Column</th><th valign="top">Remarks</th></tr></thead><tbody><tr><td valign="top"><strong>Column</strong></td><td valign="top"><strong>Remarks</strong></td></tr><tr><td valign="top">Process</td><td valign="top">Process name</td></tr><tr><td valign="top">Participant</td><td valign="top">Participant name</td></tr><tr><td valign="top">Delegator</td><td valign="top">User who delegated</td></tr><tr><td valign="top">Delegatee</td><td valign="top">User to whom delegated</td></tr><tr><td valign="top">From</td><td valign="top">Delegation start date; if not defined, the delegation is unlimited</td></tr><tr><td valign="top">To</td><td valign="top">Delegation end date; if not defined, the delegation is unlimited</td></tr></tbody></table>

## Adding a delegation

When adding a new delegation, you can decide whether or not to send a notification email to the delegatee via the displayed message box.

A delegation is unique based on the process, the participant, the delegator, the delegatee, the begin date, and the end date. This means that you cannot define multiple time periods for a given delegation.

{% hint style="info" %}
As of WorkflowGen 8.0.3:

* You can define cross-delegations on overlapping periods between the same users on the same participant.
* You can define multi-level delegations, so if user A has delegated actions to user B, user B can then delegate these actions to user C.
  {% endhint %}

## Deleting a delegation

Deleting a delegation does not delete the associated user.

## Process versioning

Delegations are process version-specific:

* New versions of a process copy all existing delegations where possible, based on matching participant names.
* For process folder managers, a delegation targets the selected Active or Archive process version in a managed folder. Changes are not synchronized to other versions by the folder manager operation. An Administrator can manage additional versions using the existing administration workflow.
* A delegatee can only see the delegator’s actions and requests from the version at which they were delegated the role, and going forward if copied by creating a new version and not changed subsequently.
* When a user changes a delegation in the current version, it does not affect prior delegations performed for previous versions.
* If prior version actions and requests also need to be delegated, an Administrator must use their delegation screen to add the prior versions' delegations.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.workflowgen.com/admin/user-management/delegations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
