# List of Files

**List of files** extension displays a list of files uploaded to the project, providing an organized overview of all files arranged alphabetically.

The extension allows for the following actions:

* **View** all files uploaded to the project.
* **Navigate** through the files.
* **Filter** files by their status.
* **Update** the status of files to indicate whether they are complete or in progress.

{% hint style="info" %}
When the s[**plit files**](https://docs.datasaur.ai/nlp-projects/creating-a-project/split-files) feature is used, individual file parts will also appear in the list.
{% endhint %}

## How to Enable the Extension

Enable it from the **Manage extensions** dialog (gear icon) in the right sidebar.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-392d888c3692d59deaae1e1335b729e825de4fcd%2FExtension%20-%20Manage%20extensions%20-%20List%20of%20files.png?alt=media" alt=""><figcaption></figcaption></figure>

## In Labeler Mode

{% hint style="info" %}
Only files **assigned to the labeler** will appear in the list. Files not assigned to the labeler will be excluded, ensuring that only relevant files for labeling are displayed.
{% endhint %}

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-118375f28d8ce6a0ca444e3c70e11e152129194c%2FExtension%20-%20List%20of%20files%20-%20labeler%20mode%20-%20highlight.png?alt=media" alt=""><figcaption></figcaption></figure>

### **File Management and Navigation**

1. **Search bar:** Quickly find specific files by entering their names.
2. **Filter:** Filter files based on their status.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-31152e491519b0175f9f9c76aca116e7a67695e3%2FExtension%20-%20List%20of%20files%20-%20labeler%20mode%20-%20filter.png?alt=media" alt=""><figcaption></figcaption></figure>

3. **File:** Clicking the file will open it.
4. **File icon**: Displays the current status of the file, differentiating between files that have not been started and those that are completed. The status can be changed by clicking the icon.
5. **Arrow buttons:** Move to the previous or next file in the list.
6. **File number field:** Jump directly to a specific file by entering its order number.

## In Reviewer Mode

{% hint style="info" %}
**All files** will be displayed in the list.
{% endhint %}

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-968d53ffe1cc586faceca436c2475bf970ce0255%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20highlight.png?alt=media" alt=""><figcaption></figcaption></figure>

### **File Management and Navigation**

1. **Update now button:** Fetches the latest status of the files.
2. **Search bar:** Quickly find specific files by entering their names.
3. **Filter:** Filter files based on their status.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-05a97bde27d0e4a26534e119bd9a076df737f0bc%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20more%20menu.png?alt=media" alt=""><figcaption></figcaption></figure>

4. **File:** Clicking the file will open it.
5. **File icon**: Displays the current status of the file, differentiating between files that have not been started and those that are completed. The status can be changed by clicking the icon.
6. **Labeler indicator:** Displays the file's completion status: completed by all labelers, completed by some labelers, or not started by any labelers.
   1. Hovering over the indicator reveals which labelers still need to complete the file.
   2. A blue triangle indicates that the reviewer is also a labeler for the file.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-58ab1430c4e037d9e4f21c3a0c0b58641c609ca1%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20labelers%20progress.png?alt=media" alt=""><figcaption></figcaption></figure>

7. **Arrow buttons:** Move to the previous or next file in the list.
8. **File number field:** Jump directly to a specific file by entering its order number.

### In-Review Document Indicator

Managing document reviews effectively is essential for large teams. **In review** document status ensures each document is reviewed by one person at a time, reducing duplication and improving the review workflow.

{% hint style="info" %}
Starting from version **6.94**, in-review document indicator is now supported. This feature is available only for team workspaces and is disabled by default.

Please reach out to [**support@datasaur.ai**](mailto:support@datasaur.ai) if your team needs this feature, and we'll assist you!
{% endhint %}

#### How It Works

Once enabled, the reviewer's name appears below the document name, showing who is actively reviewing it or changing its status. Documents can have the following statuses:

* **Not started**: Review has not yet begun.
* **In review**: The document is currently being reviewed.
* **Complete**: The review is finished.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-3a26f8998b3c3bad668541c8f4a48aa59fbf151d%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20mark%20document%20status.png?alt=media" alt=""><figcaption></figcaption></figure>

If a user who is not assigned to the project attempts to change the document's status, they will need to be assigned as a reviewer for the project first. A dialog box will automatically appear, asking the user to confirm that they wish to assign themselves as a reviewer. Once confirmed, the user can proceed to change the document's status.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-b9eadf6a6fe28c962f30287a6b05fb356026776d%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20assign%20yourself.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Review Status Permissions

When a document has **In review** status and there are multiple reviewers, changing a document’s status follows these permissions:

| **Current status**     | **New status**            | **Can it be changed?**  |
| ---------------------- | ------------------------- | ----------------------- |
| Not Started            | In Review (same reviewer) | ✅                       |
| Not Started            | Complete (same reviewer)  | ✅                       |
| In Review (Reviewer A) | Not Started (Reviewer A)  | ✅                       |
| In Review (Reviewer A) | Not Started (Reviewer B)  | ⚠ Confirmation required |
| In Review (Reviewer A) | Complete (Reviewer A)     | ✅                       |
| In Review (Reviewer A) | Complete (Reviewer B)     | ⚠ Confirmation required |
| In Review (Reviewer A) | In Review (Reviewer B)    | ⚠ Confirmation required |
| Complete (Reviewer A)  | Not Started (Reviewer A)  | ✅                       |
| Complete (Reviewer A)  | In Review (Reviewer A)    | ✅                       |
| Complete (Reviewer A)  | Not Started (Reviewer B)  | ❌                       |
| Complete (Reviewer A)  | In Review (Reviewer B)    | ❌                       |
| Complete (Reviewer A)  | Complete (Reviewer B)     | ❌                       |

#### Filter By Document Status And Its Reviewer

Reviewers can filter documents by status and by the reviewer assigned to each document. This helps teams quickly identify documents that have not been reviewed yet, are currently being reviewed, or have already been reviewed, and see who is responsible for each review.

The filter simplifies navigation, allowing users to focus on the most relevant documents and track reviewer progress more efficiently.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-766f15527bf59999c46fd4f8ffc4878d4f47d925%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20filter.png?alt=media" alt=""><figcaption></figcaption></figure>