> For the complete documentation index, see [llms.txt](https://docs.datasaur.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasaur.ai/workspace-management/project-management/self-assignment.md).

# Self-Assignment

In some workflows, you may want labelers to pick up work on their own instead of being assigned in advance. With self-assignment, labelers can assign documents to themselves from a pool of available projects. This helps ensure unassigned documents are quickly handled and gives labelers more control over their workload.

{% hint style="warning" %}
Self-assignment is not enabled by default in projects created before version 6.90.
{% endhint %}

## Enable self-assignment

Admins can enable self-assignment in workspace settings:

1. Go to the **Workspace settings** page from the left sidebar.
2. Open the **Assignment** tab.
3. Enable **Allow self-assignment for labelers.**

   <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-4301b231a85b3aba436df1b166aabe624ee1eabc%2FWorkspace%20settings%20-%20self-assignment.png?alt=media" alt=""><figcaption></figcaption></figure>
4. Click **Save changes**.

Once enabled, there are changes in the **Projects** page depending on the role:

* **Admins** and **supervisors** can see projects with incomplete assignments marked with an **Incomplete assignment** chip in the **Status** column.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-e05e13fffde012e9c578a7ba8cab05666ba136d4%2FSelf-assignment%20-%20project%20list%20-%20incomplete%20assignment.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Labelers** will see a new **Unassigned projects** tab, where they can view projects they are not assigned to and self-assign documents.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-649381d8d2ab5a8af85e56e0459ee3817f885ca5%2FSelf-assignment%20-%20unassigned%20projects%20tab.png?alt=media" alt=""><figcaption></figcaption></figure>

## Prepare projects for self-assignment

To make a project available for self-assignment, create the project as usual. In step 4 of project creation, assign only **reviewers** and leave labeler assignments empty.

![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-df21d08f8fa0513ece58c94064bdacbfd997d35f%2FPCW%20-%20step%204%20-%20assign%20reviewer%20only.png?alt=media)

## Self-assign

Once enabled, labelers can self-assign documents from three places: the **Unassigned projects** tab, the **Assigned projects** tab, or within a project.

### Unassigned projects tab

Labelers can assign themselves to a project they have not worked on from the **Unassigned projects** tab.

1. Go to the **Projects** page.
2. Open the **Unassigned projects** tab.

   ![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-649381d8d2ab5a8af85e56e0459ee3817f885ca5%2FSelf-assignment%20-%20unassigned%20projects%20tab.png?alt=media)
3. Click **Assign myself** for the desired project.
4. Enter the number of documents and click **Assign to me.**

   <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-a18162bd7f973f6e575cd526346e7a48e4230a3a%2FSelf-assignment%20-%20Assign%20myself%20more%20documents.png?alt=media" alt=""><figcaption></figcaption></figure>

The project will open automatically after a successful assignment.

### Assigned projects

Labelers can also assign themselves additional documents in projects they are already working on from the **Assigned projects** tab.

1. Go to the **Projects** page.
2. Open the **Assigned projects** tab.
3. In the desired project, click the three-dot menu and select **Assign myself to more documents**.

   ![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-a876d097a7d6a67f79d7a349cb7719f8dd942a49%2FSelf-assignment%20-%20assigned%20projects%20tab%20-%20more%20menu.png?alt=media)
4. Enter the number of documents to assign and click **Assign to me.**

   <div data-full-width="false"><figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-02f63043edf2ace5b3cfd191dfdfecda0c012e1d%2FSelf-assignment%20-%20Assign%20myself%20more%20documents%20-%20remaining%20docs%20available.png?alt=media" alt=""><figcaption></figcaption></figure></div>

The project will open automatically after a successful assignment.

### Within the project

After marking all assigned documents as complete, labelers may be prompted to self-assign more documents if the project still has incomplete assignments. They can choose to assign more documents or mark the project as done.

<div data-full-width="false"><figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-5e6df9a2aca2102a7ff5875392b123cbba5aad13%2FSelf-assignment%20-%20mark%20all%20documents%20as%20complete%20dialog.png?alt=media" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If multiple labelers self-assign at the same time, some documents may already be taken. For example, if 5 documents are requested but some are assigned by others first, only 3 may be allocated.
{% endhint %}

### Self-assignment for Admins and Supervisors

Admins and supervisors can self-assign to documents as labelers.

1. Go to the **Projects** page.
2. In the desired project, click the three-dot menu and select **Assign myself to this project**.

   ![](https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-9605e163e719b7d130484998e7fcae33b7a644eb%2FSelf-assignment%20-%20project%20-%20admin%20-%20more%20menu%20-%20assign%20myself%20to%20project.png?alt=media)
3. Enter the number of documents to assign and click **Assign to me.**

   <div data-full-width="false"><figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-a18162bd7f973f6e575cd526346e7a48e4230a3a%2FSelf-assignment%20-%20Assign%20myself%20more%20documents.png?alt=media" alt=""><figcaption></figcaption></figure></div>

The project will open automatically after a successful assignment.

## Additional configuration

You can configure the **document limit** and **time limit** for self-assignment. You can configure them in two places:

* In step 5 of project creation.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-0048800cf81c00b476ee85d76d75c72760a06c76%2FPCW%20-%20step%205%20-%20Self-assignment.png?alt=media" alt=""><figcaption></figcaption></figure>
* In a project via **File > Settings > Administrator**. Changes to time limits only apply to new assignments. Existing assignments keep the original time limit at the time of assignment.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-073026c077b08ae0fabf5603b04d0fd3db85fe10%2FProject%20settings%20-%20Self-assignment.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
These settings are project-level and must be configured for each new project.
{% endhint %}

### Document limit

The document limit controls how many documents a labeler can self-assign in a project. This helps prevent overloading and ensures fair task distribution. The minimum document limit is **1 document**, and the maximum is **1000 documents**.

{% hint style="info" %}
Since this setting applies only to self-assignment, admins and supervisors can still assign documents to labelers beyond the limit.
{% endhint %}

#### Example

If a document limit is set to 3:

* A labeler can self-assign **up to 3 documents**.
* Admins can assign **more than 3 documents** to a labeler.
* If labelers already have 2 assigned by an admin, they can only self-assign 1 more.

### Time limit

The time limit defines how long a labeler has to complete a document once it has been assigned, either through **self-assignment or by an admin**. It helps ensure timely completion and keeps projects on track.

The minimum time limit is **1 minute**, and the maximum is **480 hours and 59 minutes**. Details about the countdown:

* Countdown starts immediately after assignment. The remaining time is displayed at the top and in the **List of files** extension.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-4c5cb94f2bf32d47ac7c3b0291994b42d970c4ca%2FSpan%20labeling%20-%20self-assignment%20-%20time%20limit.png?alt=media" alt=""><figcaption></figcaption></figure>
* The countdown stops when the document is marked as complete. Once completed, the document's status cannot be reverted to **In progress**.
* If time expires, the document is unassigned and returned to the available pool.
