> 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/advanced/extensions/list-of-files.md).

# List of Files

The **List of files** extension shows all files uploaded to a project in an organized, alphabetical list. It helps you get a clear overview of all project files.

In this extension, you can:

* View all files uploaded to the project.
* Navigate between files.
* Filter files by status.
* Update file status (in progress or complete).

{% hint style="info" %}
If the [split files](/data-studio-projects/creating-a-project/split-files.md) feature is used, each file part will also appear in the list.
{% endhint %}

## Enable the extension

Enable this extension from the **Manage Extensions** dialog (gear icon) in the right sidebar.

<figure><img src="/files/Ycen5oaxTkRl8YaQY2hN" alt=""><figcaption></figcaption></figure>

## Labeler mode

In labeler mode, only files assigned to the labeler are shown. Files not assigned to the labeler are hidden to ensure focus on relevant work.

<figure><img src="/files/xCjFmNpNgL8Di6d9pgof" alt=""><figcaption></figcaption></figure>

### File management and navigation

* **Search bar:** Find files by name or ID.
* **Filter:** Filter files by status: In progress or completed.

  <figure><img src="/files/bZlbZx4RKvIkQKqByQ70" alt=""><figcaption></figcaption></figure>
* **File row:** Click to open the file.
* **File icon**: Shows file status (not started or completed). Status can be updated by clicking the icon.
* **Arrow buttons:** Move to the previous or next file.
* **File number field:** Jump directly to a specific file by entering its order number.

## Reviewer mode

In reviewer mode, **all files** will be displayed in the list.

<figure><img src="/files/p0hkkpvLvruKR4Sy8ur6" alt=""><figcaption></figcaption></figure>

### File management and navigation

* **Update now button:** Fetches the latest status of the files.
* **Search bar:** Find files by name or ID.
* **Filter:** Filter files by status: In progress or completed.

  <figure><img src="/files/x9txTEJ5coDLK6SiJLeB" alt=""><figcaption></figcaption></figure>
* **File row:** Click to open the file.
* **File icon**: Shows file status (not started or completed). Status can be updated by clicking the icon.
* **Labeler indicator:** Shows completion status per labeler.
  * Statuses
    * Completed by all labelers
    * Completed by some labelers
    * Not started by any labeler
  * Hover to see which labelers have not completed the file.
  * A blue triangle indicates that the reviewer is also a labeler for the file.

    <figure><img src="/files/RYN2mUHNVC9siIy2On6N" alt=""><figcaption></figcaption></figure>
* **Arrow buttons:** Move to the previous or next file.
* **File number field:** Jump directly to a specific file by entering its order number.

### In-review document indicator

Managing review status helps ensure documents are reviewed by one person at a time, reducing duplication and improving workflow.

{% hint style="info" %}
Starting from version 6.94, the in-review document indicator is available for team workspaces and is disabled by default. To enable it, contact support [**support@datasaur.ai**](mailto:support@datasaur.ai)**.**
{% endhint %}

#### How it works

When enabled, the reviewer’s name appears under the document name, showing who is currently reviewing it or updating its status. Documents can have three statuses:

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

<figure><img src="/files/vSG99oYByTV0WYllsiL1" alt=""><figcaption></figcaption></figure>

If a member not assigned as a reviewer tries to change a document’s status, they must first assign themselves as a reviewer. A dialog will appear to confirm this action.

<figure><img src="/files/atxpGc8ID8jUnj8alXJO" 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 (not started, in review, complete)
* Assigned reviewer

This helps teams quickly find:

* Documents not yet reviewed.
* Documents currently under review.
* Completed documents.
* Who is responsible for each review.

The filter improves navigation and helps track review progress more efficiently.

<figure><img src="/files/bj2VLmZjqS7IyeGuILZS" alt=""><figcaption></figcaption></figure>
